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3 Organization of This Manual 


PURPOSE OF PLAN80 


PLAN80 is a powerful tool for significantly improving the quality 
and timliness of plans, forecasts, budgets and analyses through 
the automated preparation of polished reports on a _ computer 
screen or printed page, 


SCOPE OF THIS DOCUMENT 


"The PLAN80 Language" teaches you to use PLAN80 for a broad range 
of planning and analytical problems. PLAN80 lets you in concise, 
easy-to-understand terms 

* describe a problem's framework in terms of rows and columns, 
input data values, 
specify calculations, 
display and/or print results, and 
communicate results between PLAN80 applications. 
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SCOPE OF THE COMPANION cee As 


"The PLAN80 Tutorial" teaches you step by step everything you 
need to operate PLAN80 on an Apple II computer equipped with the 
Apple Language System. You will use the Language System's 
outstanding Editor to input and maintain files of  PLAN80 
statements, just as if writing a letter on your computer. And 
you will use the Language System's Filer to copy, delete, and 
rename files, etc. $ The Tutorial also includes sample PLANS80 
applications and error codes. 


HOW TO PROCEED 


Read the first two chapters of "The PLAN80 Language". Then skim 
the others. You'll have a good overview, and find it easy to use 
the manual subsequently as a detailed reference, 


Learn to operate PLAN80 from "The PLAN80 Tutorial", and use’ the 
examples in Appendix A as a pattern for your own applications, 


PLAN80 should increasingly help you fulfill your potential as an 
imaginative problem solver by eliminating the drudgery of 
manipulating numbers and presenting results. 


ORGANIZATION OF THIS MANUAL 


Chapter 2 siel adie PLAN80'S capabilities and uses and provides an 
overview of its features. 


The remaining chapters present for each PLAN80 statement 
* format and content of the statement, 
* one or more examples, 
* detailed discussion of content, and 
* discussion of statement usage. 


Chapter 3 covers the framework of an application: 
* TITLES 
* COLUMNS 
* ROWS 


Chapter 4 explains how to establish data values, whether actuals 
Or assumptions. 

* DATA 

* INTERACTIVE 

* REPEAT 

* INITIALIZE 


Chapter 5 shows you how to calculate results. 
* RULES 


Chapter 6 discusses statements which print or display results. 
* PRINT : 
* DISPLAY 
* OPTIONS 


Chapter 7 explains statements which permit communications between 
PLAN80 applications. 

* PUT 

* GET 


Chapter 8 covers additional PLAN80 statements. 
* INCLUDE ; 
* FOR 
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A PLAN80 OVERVIEW 


6 What is PLAN80? 
7 Why a Computer? 3 
7 How does PLAN80 Work? 
8 A PLAN80 Example 
8 The Output 
9 The Input 
10 Commentary 
ll More About PLAN80's Elements 
11 Titles a : 


ll Columns 

12 Rows 

12 Data 

12 Calculations 


12 Output Statements 
13 Other Features 
14 About PLAN80 Syntax 


14 Use of Lower Case Characters 
14 Comments . 

14 Page Breaks 

14 Statement Listing Appearance 


WHAT IS PLAN80 ? 


-PLAN80 is a modeling system that helps you 
pran, <= 
* forecast, 
* project, 
* estimate, 
* 
* 
* 


+ 


analyze, 
contol, and 
understand 


numbers representing 
* sales, 

profits, 

costs, 

taxes, 

cash, 

marketing plans, 

cost center expense, 

R&D projects, 

market share, 

growth rates, 

return on investment, | 

capital projects, 

real estate deals, and 

discounted cash flow. 
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Whatever your application 

* sales forecasting and analysis 
profit and loss analysis 
balance sheet projections 
long range planning 
cash flow forecasting and analysis 
cost center budgeting and analysis 
project budgeting and control 
headcount control and analysis 
Salary and wage analysis 
purchase price analysis 
cost and variance analysis 
market share planning and analysis 
Capital project evaluation 
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you will probably want the results presented as a tabular report, 
And PLAN80 automates the preparation of tabular reports, 


WHY A COMPUTER? 


Without a computer, planning and analysis invariably mean working 
with hundreds, maybe thousands, of numbers. Assumptions and 
calculations must be checked and results summarized again and 
again. A difficult problem may take hours or days. 


If only someone else could do the number crunching and _ copying. 
You could spend your time more productively on other tasks. Well 
that's what PLAN80 does for you. It relieves the drudgery of 
calculating, recalculating, checking and producing high quality 
typed reports. 


HOW DOES PLAN80 WORK ? 


Every tabular report has certain common elements. Imagine that 
you are instructing an assistant to prepare a report. You would 
provide information about its TITLES, its framework in terms of 
COLUMNS and ROWS, the starting DATA values, and the RULES used to 
compute totals and other values. Also you would specify items 
such as column width, line spacing, the number of decimal 
positions, etc., to make the report visually effective. 


You use the PLAN80 language to instruct your computer with this 
same information. Since your computer is not as bright as a 
human assistant you must be very precise. But your electronic 
helper is extremely fast and unfailingly accurate. 


A PLAN80 EXAMPLE 


: j t was 
Let's look at a PLAN80 example. The following repor 
prepared from the first example included on your _PLAN80 
distribution diskette. It projects net income as a function of 
sales, costs and taxes and calculates margins for gross profit, 


operating profit and net income. 


THE OUTPUT 
PLAN80 EXAMPLE #1 
FIVE YEAR PROFITABILITY MODEL 
' 1981 1982 1983 1984 1985 
ASSUMPTIONS 
UNITS 100 118 142 170 204 
PRICE 1.32 1.49 1.64 1.80 1.98 
UNIT COST 0.818 0.919 1.029 1.153 1.291 
TAX RATE 0.460 0.460 0.460 0.460 0.460 
DOLLARS (THOUSANDS) ; 
SALES 132 176 232 306 404 
COST OF SALES 82 108 146 196 263 
OVERHEAD 17 19 21 22 24 
PROFIT BEFORE TAX 33 48 66 88 117 
TAXES 15 22 30 41 54 
NET INCOME 7 18 26 36 48 63 
MARGINS (PERCENT) 
GROSS PROFIT 38.0 38.3 37.2 36.1 34.9 
OPERATING PROFIT 25.2 27.5 28.4 28.8 29.0 
NET INCOME 13.6 14.9 15.3 15.6 15.6 


THE INPUT 


The above report resulted from the following PLAN80 statements: 


: TITLES 

1 "PLAN80 EXAMPLE #1" 

2 "FIVE YEAR PROFITABILITY MODEL". 
; COLUMNS : 

Y1981 "1981" 

Y1982 "1982" 

Y1983 "1983" 

y1984 "1984" 

y1985 "1985" 


:ROWS . 
UNITS "ASSUMPTIONS" 
" UNITS" 
PRICE (2) " PRICE" 
ucOsT (3) " UNIT COST" 
TAXRT (3) "TAX RATE" 
SALES "DOLLARS (THOUSANDS) " 
" SALES" 
cost " COST OF SALES" 
OVERHEAD " OVERHEAD" | : 
PBT (-) " PROFIT BEFORE TAX" 
TAXES "TAXES" 
NET (-=) " NET INCOME" 
GPM =~ (11) "MARGINS (PERCENT) " 
"GROSS PROFIT" 
OPM (1) " OPERATING PROFIT" 
NPM (1) " NET INCOME" 
:DATA 
UNITS = 100 118 (*1.20) 
PRICE = 1.32 1.49 (*1.10) 
UCOST = .818 .919 (*1.12) 
TAXRT = 46 + 
OVERHEAD = 17 19 (*1.08) 
: RULES : 
SALES = UNITS * PRICE 
COsT = UNITS * UCOST 
PBT = SALES - COST - OVERHEAD 
TAXES = TAXRT * PBT 
NET = PBT - TAXES 
GPM = 100 * (SALES - COST) / SALES 
OPM = 100 * PBT / SALES 
NPM = 100 * NET / SALES 
sDISPLAY _ 


COMMENTARY ON EXAMPLE 4 


Note that the PLAN80 statements are divided into sections 
(TITLES, COLUMNS, ROWS, DATA and RULES) similar to those used in 
the general description of tabular reports, 


The TITLES section introduces the two title lines at the top of 
the report. 


Columns and rows are defined in COLUMNS and ROWS sections, | Each 


definition begins with a name, optionally followed by numbers or 


characters within parentheses. The numbers control the decimal 
positions shown, and the other characters control under. and 
overlining and other printing options. Printed descriptions are 
contained in quotes, 


In DATA statements values may be assigned to rows on a column by 


column basis or to columns on a row by row basis. Furthermore, 


the values may be individualy specified or calculated as part of 
a series, For example, units are 100 and 118 for the first two 
periods and increase at a 20% rate thereafter, and the tax rate 
is 46% for all periods. 


The RULES statements indicate calculations: sales as units times 
price, cost as unit cost times sales and profit before tax as the 
result of sales less cost and overhead, Taxes are a result of 
the tax rate times profit before tax, and net income equals 
profit before tax less taxes. The margins are calculated by 
dividing various quantities by sales, and are multiplied by 100 
to convert the results to percentages. 


The DISPLAY statement allows you to view results on your computer 
screen or to print the report as was done for the example. 
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MORE ABOUT PLAN80'S ELEMENTS 


TITLES 


A title in PLAN80 may include up to nine lines to introduce’ the 
reader to the report. Lines may be up to 60 characters wide and 
may be left or right justified if centering is not desired. 


COLUMNS 


A tabular report must have at least one column. For example, a 
list of outstanding checks would comprise a single column. At 
the other extreme a report could have dozens (or hundreds) of 
columns. Imagine a worksheet showing expenses for each week of 
a year. You might need many pages for the output but you would 
still have one report. 


In PLAN80 each column has a name. Names are used to identify 
columns when entering data as in 


COLA = 10 20 25 30 
and names identify columns involved in calculations as in 
COLX = COLA + COLB 


Names may be up to eight characters long and the first character 
must be alphabetic. SALES, COST06 and C52 would be valid names. 


In addition to a name each column may have a one, two or three 
line description that is printed at its head whenever it is 
printed or displayed on a computer screen. A typical description 
might be "JANUARY" or "MOST" "LIKELY", where the word "LIKELY" 
would be printed immediately below the word "MOST". 


Column specifications may also indicate 


* when a column should start on a new page, and 
* the number of decimal positions to be displayed. 
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ROWS 


Row specifications define the structure and certain printing 
characteristics associated with a report's rows. Row descriptions 
may be broken into any number of lines to provide headings for 
groups of related rows. 


Row specifications may also indicate 
* when a row should start on a new page, 
* when one or more blank lines should preceed the row, 
* when underlining should occur to highlight totals, and 
* the number of decimal positions to be displayed. 


DATA 


Data may be entered into any row or column, and the range of rows 
applying to entry by column (or the range of columns applying to 
entry by row) is under your control. You can conveniently place 
values into any part of a PLAN80 application. For instance, you 
might want to enter data into a series of months, but skip quar- 
terly subtotals. Or you might want to input values for the month 
of June, skipping over January through May. 


Furthermore, from any starting value subsequent values may be 
generated which change by either a constant amount or percent. © 


CALCULATIONS 


PLAN80 employs a language based upon mathematical relationships. 
Furthermore, PLAN80 has many sophisticated capabilities, such as 
trigonometric functions, internal rate of return, etc. Typical 
statements might be: 


TAX = PROFIT * .46 


YEAR = @SUM(JAN. .DEC) 
ROWX = ROWA - (ROWB * ROWC) 
OUTPUT STATEMENTS 


The previous elements define structure and provide data and rules 
for creating new values. Lastly, statements are required to put 
the freshly created results into a form for subsequent use, 


The DISPLAY mode permits you to display results on the computer 
screen. Scrolling commands allow you to view any portion of a 
report and to control a report's appearance. Also from the 
DISPLAY mode you may print a report on your printer. 


- 12 - 


The PRINT statement causes printing of reports without further 
operator intervention. The OPTIONS feature may be used to change 
printing options. 


The PUT statement allows you to save portions of the values 
within a PLAN80 application on disk for subsequent use by a GET 
statement. This feature permits PLAN80 to consolidate financial 
statements or support interrelated planning models which feed 
into a summary model. 


OTHER FEATURES 


The above PLAN80 elements enable you to create powerful 
applications for planning and analysis. PLAN80 has still other 
features which will enhance its value to you. _ 


* Data may be changed interactively. This is particularly 
useful in examining the sensitivity of results to alterna- 
tive assumptions about data values. 


* You may INCLUDE external files that contain PLAN80_ state- 
ments, This allows one set of column or row definitions to 
be used by many applications and it allows one application 
to handle an unlimited number of sets of data, as would be 
required in building cost center budgets for a large number 
of cost centers. This feature may also be used in examining 
the effects of many different groups of data or calculation 

- assumptions. 


* Using the PUT and GET statements it is possible to construct 
models of any size. | 


ABOUT PLAN80 SYNTAX 


Each PLAN80 statement must begin on a new line, but the statement 
may begin in any column. 


Statements may be continued on any number of lines, but elements, 
such aS names, numbers, descriptive data in quotes, etc., may not 
be divided by blanks or line breaks. 


Any number of blanks may occur between the elements of a PLAN80 
statment. 


USE OF LOWER CASE CHARACTERS 


Use of lower case characters in PLAN80 statements should be 
restricted to title, column and row descriptions. Keyboard 
response may be in upper or lower case. 3 


COMMENTS 


A PLAN80 statement listing is usually self documenting. However, 
comments are sometimes desirable. If a line begins with a colon 
followed by a blank then the line is treated aS a comment. If a 
colon occurs after a blank and not within quote marks then all 
characters to its right are treated.as a comment. 


: THIS LINE IS A COMMENT 
INCOME = SALES - EXPENSE :THIS IS A COMMENT 


PAGE BREAKS 


You may control page breaks in a PLAN80 statement listing through 
use of page statments 


: PAGE 


STATEMENT LISTING APPEARANCE 


PLAN80 has few format restrictions. You should use indentation, 
spacing and multiple lines to achieve a visually pleasing listing 
of your PLAN80 statments. It will then be easier to review your 
assumptions and calculations with others having no knowledge of 
PLAN80. And months after you have last looked at an application 
you will understand it more quickly in order to update it for 
current needs. 


- 14 - 


CHAPTER 3 


DEFINING THE FRAMEWORK 


16 A "TITLES" Section 


16 An Example 

16 Relative Line Number 

17 Left or Right Justification 
17 Use of Quote Marks 

17 Redefining Title Lines 

17 Eliminating Title Lines 


18 A "COLUMNS" Section 
18 An Example. 


18 Column Names 

18 Page Breaks 

19 Decimal Point Specification 

19 Specification Precedence 

19 Summary of Print Specifications 

19 Effect of Unused Heading Lines 

20 Controlling Column Heading Appearance 
20 When No Description is Provided 

21 Placement of a Columns Section 


21 A "ROWS" Section 
22 An Example 


22 Row Names 

23 Page Breaks 

23 Blank Lines 

23 Overscore and Underscore 

23 Decimal Point Specification 

24 Specification Precedence 

24 Summary of Print Specifications 
25 Multiple Line Headings 

25 When No Description is Provided 
25 Placement of a Rows Section 


- 15 - 


A "TITLES" SECTION 


Title statements must occur within a titles section headed 
TITLES 


Bach title statement contains 
-the relative line number, 
* whether the title is to be RIGHT or LEFT justified, if not 
centered, and 
* the characters comprising the title line, enclosed in quotes, 


Each title statement must begin on a separate line and may not 
extend to a second line. 


AN EXAMPLE ‘ 


The following statements define a four line title with the first 
line printed on the left, and the next three centered. 


s TITLES 

LEFT "3/31/85" 

"JANUS MASKS, INC." 

"SALES ANALYSIS (1979-1984) " 
"(THOUSANDS OF DOLLARS) " 


m WHF 


RELATIVE LINE NUMBER 


A relative line number is used to control the placement of title 
lines in a title that may be up to nine lines long. 


Titles may be double spaced by using every other line number as 
ins 3 and. 5. Lines 2 and 4 in this case would be printed as 
blank lines. If the last line noted is 5, only five lines will 
be printed. 3 


In applications using only a single title line the line number is 
optional. Whenever a line number between 2 and 9 is not 
provided, PLAN80 assumes the new title applies to the first title 
line. 
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LEFT OR RIGHT JUSTIFICATION 


The data on the first line of the example above would be justi- 
fied left and the other three lines would be centered between the 
first and last columns of each printed page. Any line could be 
moved to the far right by placing the word "RIGHT" between’ the 
line number and the title data. 


USE OF QUOTE MARKS 


Title data must occur between double quotes. Any printable 
character may be entered between the quotes, except, of course, 
a double quote. Each line is limited to 60 characters. 


REDEFINING TITLE LINES 


In complex applications, as ina sensitivity or "what if?" 
analysis, it is possible to redefine one or more title lines used 
previously. For example, the first several lines of an applica- 
tion may be standard ones (company name, project name, etc.) and 
the last could be used to introduce a description of the case or 
situation being analyzed. It could then be redefined for each 
case. 


In replacing a previous line there is no need to "erase" the 
original line. The new . one will overlay the first 
completely, even if the second is shorter than the first or is 


placed at a different position on the page (e.g., justified right 
instead of centered). 


ELIMINATING TITLE LINES 
To eliminate all titles defined previously you may place the word 
"RESET" after the titles statement as in 

sTITLES RESET 
or to eliminate a single line without adding any characters to be 
printed you may replace a line's contents with "nothing" as_ in 


the following example 


: TITLES 
3 oo : 


This example would cause line 3 to be printed as a blank line. 
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A "COLUMNS" SECTION 


Column statements must occur within a columns section headed 
: COLUMNS 


Each column statement must contain | ‘ 
* the internal name of the column, which is used in data, 
calculation and certain other control statements. 
In addition any column statement may contain 
* an indicator "P" if the column is to begin on a new page 
when results are being printed, 
* the minimum number of decimal positions to be displayed for 
all values within a column, 
* an indicator "X" if the line is not to be printed, and 
* column headings of up to three lines with each line contai- 
ning up to eight chracters within double quote marks. 


Each column statement must EGE! on a new line, and may continue 
on subsequent lines. 


AN EXAMPLE 


The following lines define four columns: 


: COLUMNS 
A1981 "ACTUAL" "1981" 
B1962..(2) —* . PLAN". "1980" : 
P1983. (P3). " PLAN". "1983" 7 
TOTAL (3) 
COLUMN NAMES 


The four columns above have the names Al981, P1982, P1983 and 
TOTAL. Names must begin with an alphabetic character ("A" 
through "Z") and may be as long as eight characters, The second 
and subsequent character may be numeric ("0" through "9") as well 
as alphabetic. You may not use any other characters. You should 
use meaningful names, such as JAN, QTR2, ALT3, etc. 


PAGE BREAKS 


\ 


The above columns would be printed on two separate pages because 
of the "P" indicator in the third line. The "P" causes’ the 
column named COLC to begin on a new page. (Notes: the printer 
will automatically provide a new page for the first column.) 
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DECIMAL POINT SPECIFICATION 


The first column has no decimal point specification and _ the 
others specify that two or three positions be printed to. the 
right of the decimal point. The specification only affects the 
way that values within the column.are printed. 


SPECIFICATION PRECEDENCE 


If there is a decimal point specificaton for both a row and a 
column then the larger of the two specified values will be used. 
For example, if ROWA has a specification of three positions and 
COLX has a specification for none, one or two positions, then the 
value printed at the intersection of ROWA and COLX will show 
three positions to the right of the decimal point. 


SUMMARY OF PRINT SPECIFICATIONS FOR COLUMNS 


Page and decimal point information must be specified between 
parentheses "(" and ")" after the column name and before the 
double quote which introduces descriptive headings. Between the 
parentheses may be any of the following: 


“p® - indicates that a new page should occur before the column 
is printed, 


“n" - a digit between "1" and "6" to specify the minimum number 
of positions to be printed to the right of a decimal 
point. When this parameter has been specified for both 
rows and columns the larger prevails. No decimal point 
will be printed for a value whose row and column 
specifications have no decimal point indicator. 


“X" = sometimes it is convenient to set aside temporary columns 
to hold intermediate calculation results. An "X" causes 
PLAN80 to ignore the column during printing. The column 
will, however, be displayed on the screen for possible 
confirmation of intermediate results. 


EFFECT OF UNUSED HEADING LINES 


The first three lines of the example above use two of the three 
available column headings, and the third will be printed in each 
case as a blank line as though the specification had been: 
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: COLUMNS 
COLA “ACTUAL” "1981" " . 
COLB (2) “ PLAN" *1982". * “d 
COLC (P3) “° PLAN" °1983". " . 


The fourth line of the original example is a special case in 
which no descriptive information is provided. The letters 
"TOTAL" in this case are used as_ though the original 
specification had been: 


TOTAL * ROTAL gives A 
Anytime that descriptive information is not explicitly provided 
the column name is used as a one line description. 


CONTROLLING COLUMN HEADING APPEARANCE 


The descriptive information between quotes may be any character 
except a double quote, including leading and trailing blanks. 
When reports are prepared the desription of each line is right 
justified as shown in the following example: 


COLN "ACTUAL" "1ST" "QUARTER" 
would print as 
ACTUAL 
1ST 
QUARTER 


It is possible to form intermediate headings, covering groups of 
columns, as in the following example: 


Ml @ pas | " JAN“ 
M2 © ren en awer es 1" “PEB" 
M3 "ST QTR -" "MAR" 
Ql 20 ee ca exw cow er ene cave eo Ld "TOTAL * 


WHEN NO DESCRIPTION IS PROVIDED 
The column name is used as a description if no description is 
provided. In other words, the following are equivalent. 


COL99 
/ COL99 "“COL99* 
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PLACEMENT OF A COLUMNS SECTION 


Normally a COLUMNS section will occur only once in any PLAN80 
run. At least one column must be entered before any rows may be 
Gefined or data or calculations entered. Only TITLES and OPTIONS 
(for print) sections may preceed the first COLUMNS section. 


If a second COLUMNS section is encountered then PLAN80 assumes 
you are beginning a new application within the same physical run. 
This is permissible and is an effective way to handle complex 
runs which require no operator intervention. All prior defined 
columns, data and previously computed values will be forgotten. 
Any TITLES and OPTIONS will survive the introduction of a new 
COLUMNS section, however. 


A "ROWS" SECTION 


Row statements must occur within a rows section headed 
:ROWS. 


Each row statement must contain 
* the internal name of the row, which is used in data, calcu- 
lation and in certain other control statements. 
In addition any row statement may contain 
* an indicator "Pp" if the row is to begin on a new page when 
results are printed, : 
* an indicator "S" for each blank line, up to three, that is 
to occur before the row is printed, 
* an indicator “-" or “=" if the row should have an over or 
underscore to highlight totals, 
* the minimum number of decimal positions to be displayed for 
all values within the row, 
* an indicator "xX" if the line is not to be printed, and 
* row heading information which can occur on any number of 
lines. . 


Each row statement must begin on a new line, but may continue on 
subsequent lines. : 


‘ 
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AN EXAMPLE 


The following lines define nine rows: 


:ROWS 
ROWA (P1) “EASTERN REGION® 
“ NEW YORK" 
" ALBANY" 
ROWB (1) " BUFFALO" 
ROWC (1) “  CHAMPLAIN" 
TOT] (1-) 7” TOTAL NEW YORK" 
ROWL (Sl) “ NEW JERSEY* 
" LAKEWOOD" 
ROWM (1) * MONTCLAIR" 
ROWN (1) “ NEWARK" 
TOT2 (1-) - TOTAL NEW JERSEY" 
TOT3 (Sl== - TOTAL EASTERN REGION" 


These lines would print as follows: 


EASTERN REGION 


NEW YORK 
ALBANY XXX 
BUFFALO XXX 
CHAMPLAIN XXX 
TOTAL NEW YORK xxx 
NEW JERSEY 
LAKEWOOD XXX 
MONTCLAIR . xxx 
NEWARK XXX 
TOTAL NEW JERSEY XXX 
TOTAL EASTERN REGION xxx 
ROW NAMES 


The nine rows have the names ROWA, ROWB, ROWC, TOT1, etc. Names 
must begin with an alphabetic character ("A" through "Z2") and may 
be as long as eight characters. The second and subsequent 
characters may be numeric ("0" though "9") as well as alphabetic, 
You may not use any other characters. You should use names that 
convey as much meaning as possible or that closely parallel 
existing account numbers, organization numbers, etc. 


- 22 - 


PAGE BREAKS 


ROWA begins on a new page because of the "p" indicator on the 
first line. (Usually a "P" is not required on the first row, 
because the printer will already be positioned to a new page and 
the "Pp" would cause another page break.) 


BLANK LINES 


Between the lines "TOTAL NEW YORK" and "NEW JERSEY" there is a 
blank line because of the "S" (for space) indicator used in the 
ROWL specification. Also the final total "TOTAL EASTERN REGION" 
is separated from the "TOTAL NEW JERSEY" line by a blank line due 
to the "S" in the TOT3 specification. 


OVERSCORE AND UNDERSCORE 


The "TOTAL NEW YORK" and "TOTAL NEW JERSEY" lines are preceeded 
by an overscore which separates the totals from their details. 
These are caused by the hyphens "-" appearing in the TOT and 
TOT2 specifications. : 
The "TOTAL EASTERN REGION" line is preceeded by an overscore and 
followed by an underscore due to the equals signs "=" which 
‘appear in the TOT3 specification. 


DECIMAL POINT SPECIFICATION 


All lines will be printed with one decimal point because of the 
"1". which appears in each specification. Note that in reports 
where all data are to be printed with the same number of decimal 
points and the number of columns is small, then it may be easier 
to place the decimal point indicator in only the column 
specification. Note that this specification has no effect on the 
values within a row, only on the way that they appear. 


SPECIFICAT ION PRECEDENCE 


If there are decimal point specificatons for both a row and a 
column then the larger of the two specified values will be used. 
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SUMMARY OF PRINT SPECIFICATIONS FOR ROWS 


Each row specification may contain information which controls 
pagination, spacing, decimal point positioning, etc. Specifica- 
tion of this information occurs between parentheses "(" and ")" 
and is placed after the row name and before the quote mark which 
introduces descriptive headings. Between the parentheses may be 
any of the following: ; 


"Dp" — indicates that a page break should occur before the row 
is printed. 


"So" —~ indicates that a blank line should occur before the row 
is printed. Up to three "S" characters may be _ used. 
Fach "S" will result in one blank line. 


"x" — sometimes it is convenient to set aside temporary rows to 
hold intermediate calculation results. An "X" causes 
PLAN80 to ignore the row during printing. The row will, 
however, be displayed on the screen for possible confir- 
mation of intermediate results. 


"n" — a digit between "1" and "6" to specify the minimum number 
of positions to be printed to the right of a decimal 
point. When this parameter has been specified for both 
rows and columns the larger prevails. No decimal point 
will be printed for a value whose row and column 
specifications have no decimal point indicator. 


"—-"— you may input any two characters other than those noted 

Or above to print an over or underscore. Usually the chara- 

"=" cters would be a minus or an equals sign because they 
highlight effectively. However, periods, asterisks or 
blanks, etc., could be used. The first character always 
applies to an overscore, printed before the line, and the 
second to an underscore, printed after the line. (If you 
want only an underscore then a suitable character may be 
added to the specification of the following row.) 
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MULTIPLE LINE HEADINGS 


Row descriptions and headings may occur on any number of lines, 
though each line must be enclosed in quotes and the total number 


of characters is limited to 256 for each row. 


In the row specification any number of print lines may be 
specified on a single input line as in 


ROWX "LINE." =") LINE 2" .” LINE 3° 


However, the technique of lining up the left-most row description 
quotes makes it easier to visualize the printed effect as in 


ROWX "LINE 1" 
" LINE 2" 
"LINE 3" 


WHEN NO DESCRIPTION IS PROVIDED 


The row name is used as a description if no description is 
provided. In other words, the following two row specifications 
are equivalent. 


ROW99 
ROW99 "ROW99" 


PLACEMENT OF A ROWS SECTION 


Normally a ROWS section will occur only once within a PLAN80 
application. Furthermore, at least one row must be’ specified 
before any data may be entered or any calculations performed. 
A TITLES or OPTIONS section may preceed any ROWS section, anda 
COLUMNS section must preceed a ROWS section. 


If a second ROWS section is encounted then PLAN80 assumes you are 
starting a new application within the same physical run. This is 

permissable and is an effective way to handle complex runs’ which 
require no operator intervention. All rows, data and previously 

computed values will be forgotten. Any TITLES, COLUMNS and 

rapes will survive the introduction of a new ROWS’ section, 
Oowever. 
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A "DATA" SECTION 


Data statements must occur in a data section headed 
:DATA 
Each data statement contains 
* a row or column name, 
* an equals sign "=", and 
* a series of numbers and/or certain other characters, 


Each statement must begin on a new line, but statements may be 
continued on as many lines as nessary. 


A PLAN80 aplication may have any number of data sections. 


SOME EXAMPLES 
sDATA 
SALES = 100 120 /// 160 
ADMIN = 16 18 (*1.08) 
INDEX = (+1) 
LONGONE = 101. 102 103 104 
105 106 107 108 
ENTRY OF DATA 


To discuss the entry of data into PLAN80 let us think of the 
columns and rows as determining a checkerboard, or matrix, as 
follows. Also think of each box, or cell, as having a value of 
zero before any data is entered. 


ROW] } Oo | 0 | 0 : 

ROW2 | a | 0 | 0 ! 

ROW3 | 0 | 0 | 0 | 

ROW4 | 0 | 0 | 0 | 
ROW OR COLUMN ENTRY 


Data may be entered across any row or down any column. ~ The 
method used is determined by the name used in the data statement. 


- 28 = 


If it is a row name, say ROW2 in the above example, then the 
data values that follow the name ROW2 will be assigned to COLA, 
COLB, etc., repectively. For instance, the data statment 


ROW2 = 10 20 30 


will cause the cell at the intersection of ROW2 and COLA to 
contain 10. The cell at COLB will contain 20, etc., as follows: 


COLA COLB COLC 


ROW1] | Oo | 0: te oe 
swe | 01 0 | ae | 
BE Aco hd 0 le od 
ROW4 [er ae 6 


Similarly a second data statement, coming after the first, 
COLB = 40 50 60 70 
would produce the following result: 


COLA COLB COLC 


ROW1] | 0 | 40 | 0 | 
oe a 
Ss Beer neers 
me ke ee ee 


Note that the 50 of the second statement replaced the 20 of the 
first in the ROW2,COLB cell. Data are always assigned on a 
replacement basis in the order encountered, 


LENGTH OF THE DATA STATEMENT 


The data statement need not have the same number of data elements 
as the number of rows or columns. For instance, the statement 


ROW4 = 100 200 


in addition to the previous ones would result in 
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COLA COLB COLC 


RAD CUED CARY CHE GENO GOED EX CEND GY WEED GO GRO GD Ge GED GD GED > Gas ED 


ROW] | 29 =| 40 | 0 | 
a eee wee 
oe as ot endo 
2 ee ra yw eae 


Had the ROW4 statement contained four or more numbers as in 
ROW4 = 100 200 300 400 


then the 300 would have been assigned to the ROW4,COLC position, 
but the 400 (and any subsequent numbers) would have been ignored. 


DATA GENERATION 


Often when data are input for a significant number of periods, 
the first few will represent "actual" experience or a firm "plan" 
and those following will be "estimated" or "projected" future 
values, Also the last absolute value is frequently used as a 
base to create subsequent projected values. For example, sales 
units for last year and this year's plan may be “hard" numbers, 
but subsequent year values are frequently constructed as an 
increase of a particular percentage or absolute amount over’ the 
last firm number. PLAN80 provides several shorcut methods for 
generating new data. 


CHANGE BY A CONSTANT PERCENTAGE 


As an example, let us assume that after several values you want 
to set the remaining values to increase by 10% over each prior 
period. The following would achieve this effect: 

ROWX = 80 100 (*1.10) 


If six columns had been defined then the above statement would be 
equivalent to: 


ROWX = 80 100 110 4121 133.1 146.41 
Similarly a declining relationship may be produced by 
ROWX = 100 (*.90) 


which for four columns is equivalent to 
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ROWX = 100 90 81 72.9 
The above technique is useful for producing numbers which 
increase or decrease by a constant percentage over time. It is 
also possible to produce the same effect by division. For 
example, the statement 

ROWX = 100 (/1.10) 
is equivalent to 2 


ROWX = 100 90.9091 82.6446 75.1315 etc. 
_ CHANGE BY A CONSTANT AMOUNT 


It is also possible to generate data values that change by a 
constant amount as shown by the following two examples: 


ROWX 
ROWY 


100 (+2) 
50° . (3) 


which would be equivalent to 


ROWX = 100 102 104 106 108 etc. 
ROWY = 50 47 44 41 38 etc. 
REPETITION 


A value may be repeated using a slash "/" as in the following: 


10 20 /// 
10 /// 20 


These statements are equivalent to: 


ROWX 
ROWY 


ROWX = 10 20 20 20 20 
ROWY = 10 10 10 10 20 


A value may be repeated to the end of a row or column by using a 
plus "+" as in the following. The "+" must, however, be the last 
character of a data input statement: 


ROWX = 10 20 + 
ROWY = 10 + 20 <-- not permitted 


The first of the above statements is equivalent to 


ROWX = 10 20 20 20 20 20 etc. 
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SKIPPING 


Sometimes it .is desirable to skip one or more rows or columns 
when entering data. Skipping may be done within an individual 
statement or may be controlled in general for groups of 
statments using the FOR statement. 

For skipping in individual statements an asterisk "*" is used. 
Assume, for instance, that the first three rows had data that 
were not to be changed, but that you did wish to change data in 
rows four through seven of a particular column, This could be 
accomplished with the statement 


COLs. = * -* ole: 35. le ee 


The asterisks "*" may occur anywhere that a number may occur, 
They have no value, unlike zero, which is a value and which would 
replace some other value. A statement of the form 


COLA = 10 -* 20° * 90. * a0 


is valid. As with a statement containing only numeric values 
only as many values will be used as can fit into the row or 
column named at the beginning of the statement. 


MIXING FEATURES 


Most of the features discussed so far may be used together within 
a single data statement. For example, the following statements 
are valid (though they may be confusing and probably should be 
avoided) : } 


COLA = °10 /// - (*1.10) 
ROW2 = 10 * + 
ROW3 = / / (+1) 


These examples are equivalent to: 


COLA = 10 10 10 10 11 £ etc, 
ROW2 = 10 10 * 10 10 etc. 
ROW3 = 0 0 1 2 3 etc. 


In the first example the "///" repeats the 10 three times, and 
the "(*1.10)" functions as it does normally. The second demon- 
strates that a slash "/" repeats the most recent value even 
though one or more no-value asterisks "*" intervene. The third 
example demonstrates that an initial previous value of zero is 
assumed at the start of each statement. : 
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USE OF THE “FOR” STATEMENT 


It is also possible to control the entry. of data using a FOR 
statement. The exact format of the FOR statement is covered 
elsewhere, but a discussion of what it does and how it works is 
appropriate at this point. In brief, the FOR statement makes 
PLAN80 behave as though one or more rows and/or columns did not 
exist. (A FOR statement, using the ALL parameter, is also used 
to make PLAN80 recognize those same rows or columns again.) 


It is probably easiest to understand the FOR statement in terms 
of some examples. Let's use the checkerboard again: 
a : 

COLA COLB  COLC 


2D NG GE Ga GP GaP Ca GRIN AHN GMD GD GD GED Ga Uew GES EE EMD CD ED 


ROW] i eS 0 | Oo | 
wet oP Re 
ae 
mgei ty a1 


If the statment 
:FOR COLUMNS = (COLA,COLC) 


which omits COLB is encountered then PLAN80 becomes blind to COLB 
until another FOR statement recognizes COLB. The statement 


ROW2 = 10 20 30 
would result in the following: 


COLA COLB COLC 


ROW] | 0 | 0 | 0 | 
ee ery 
me ero et 
ool et 


Note that the COLB position was skipped as expected, and that the 
20 value was put into COLC, not the 30. This feature is useful 
in providing actual data to a particular column, the month of 
June, for example, and avoiding those for January through May. 
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DIFFERENT INPUT SCHEMES 


We will look at five methods of inputting to the month of June. 
Often the FOR approach, covered last, is the most desirable. 


METHOD 14 


Input on a row basis, repeating actual data from previous months: 


SALES = 106 108 115 98 118 125 
COsTS = 60 60 62 58 64 68 

ADMIN = 10 9 Bg 10 12 
etc. : 


This method is very effective for smaller applications. Prior 
month data may be corrected easily. But the possibility of 
accidently changing a prior month number might make this approach 
undesirable. 


METHOD 2 


Input on a row basis, skipping prior months: 


SALES = * * ee * * 125 

COSTS = * * * * * 68 

ADMIN = * * * * * 12 
etc. 


This method is easy in January but awkward in December. You have 
to count the asterisks to know what month is being updated. 
Forgetting to add an asterisk each month would result in data 
being assigned to the wrong column. 


METHOD 3 


Input on a column basis: 
JUNE = 125 68 12 etc. 
This is a very clean approach if data are readily available in 


the right sequence, However, if new rows ever need to be 
inserted this becomes a poor approach. 
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METHOD 4 


Input on a row basis into a dummy column and then move the data 
from the dummy to the JUNE column: 


SALES = 125 

COSTS = 68 

ADMIN = 12 
etc. 


This is often a good approach, but it does introduce an- 
extraneous column, 


METHOD 5 


Input on a row basis directly into the JUNE column: 


:FOR COLUMNS = (JUNE) 


:DATA 
SALES = 125 
COSTS = 68 
ADMIN = 12 

etc 


:FOR COLUMNS = ALL 
/ 


This approach is frequently the best if Method 1 is not feasible. 
Note that if the second FOR statement is omitted a subsequent 
RULES or DATA section may be affected. 


DATA FORMAT 


Input values may contain a leading minus sign, a decimal point 
and/or a scale factor as in the following: 


ROWX = 105 <-11 . -12.964 -1.893E-16 .00306 2.92E18 


You must be careful not to embed blanks, commas or any other 
characters other than those shown. 


DATA PRECISION 


The precision of a number (the number of significant digits) is a 
machine limitation, equal to six or seven digits for most micro- 
computer systems. For example, if the number 999,999,999 is 
entered (without the commas, of course) it will be treated as 
1.000000 * 10°9 (read one times ten to the ninth power) which is 
off by one part in a billion. 
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This same number could be entered as 1.0E9 or 10E8, etc., where 
the number following the "E" is a power of ten. The power of ten 
may be negative as in 1.0E-6 to represent the very small number, 
0.000001. Very few business problems will need the "E". scaling 
feature, but it is available for those who do need it. The 
maximum and minimum "E" values are machine dependent, usually +38 
and -38 respectively for most microcomputers. : 


THE "INITIALIZE" STATEMENT 


The format of the INITIALIZE statement is: 

s INITIALIZE 
The INITIALIZE statement zeroes all values. PLAN80 always does 
this at the end of a ROWS section. However, you may process 


multiple sets of data within one application, using INITIALIZE to 
insure that no values remain from a prior set. 


The "INTERACTIVE" Mode 


The INTERACTIVE mode is initiated with the statement 
s INTERACTIVE 


When PLAN80 encounters the INTERACTIVE statement the following is 
displayed on your screen: 


INTERACTIVE DATA CHANGE 


C - INPUT COLUMN NUMBER 

R - INPUT ROW NUMBER 

I - MOVE UP 

J - MOVE LEFT 

K - MOVE RIGHT | 

M - MOVE DOWN 

X ~ LEAVE INTERACTIVE MODE 

! - QUIT CURRENT FILE 

# - EXIT PLAN80 

COL 1 <name> <description> 
ROW 1 <name> - €description> 
CURRENT VALUE = XX .XX 


INPUT NEW VALUE OR COMMAND CODE: 
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PURPOSE OF THE INTERACTIVE MODE 


The INTERACTIVE feature is generally used with the REPEAT 
statement to form a loop which lets you 


1. enter new values in the INTERACTIVE mode, 


2. calcuate results using RULES created previously, and 
3. view results and repeat or leave the loop. 


HOW IT WORKS 


In the INTERACTIVE mode one value at a time is displayed. It is 
identified in terms of column and row numbers, names. and 
descriptions. Scrolling commands let you advance quickly to any 
other location. You may move in any direction -- up, down, right 
Or left -- or jump to a particular column or row. You may move 
without affecting any current values or you may enter a new value 
at any point, 7 


ENTERING NEW VALUES 


You may type a new value, using a minus sign and/or a_ decimal 
point if necessary, and press RETURN, I,J,K or M. Your new value 
will replace whatever value was showing at the time you’ pressed 
one of these keys. The display will remain at the same 
column/row location if you use the RETURN key, but will advance 
as noted below if you use one of the direction keys. 


You may use the left arrow key to backup over anything typed if 
you have not pressed RETURN or one of the direction keys. 


C-INPUT COLUMN NUMBER 


When you key "C" you will see the message 
INPUT COLUMN NUMBER: 


Type the number of the column you want and press RETURN. 


R-INPUT ROW NUMBER 


When you key "R" you will see the message 


INPUT ROW NUMBER: 


- 37 - 


Type the number of the row you want and press RETURN. 


I, J, K, M-MOVE UP, LEFT, RIGHT OR DOWN 


Any of these keys will advance the display in the direction 
noted, If no new value has been entered then the current value 
will be left intact, otherwise the new value will replace the 
current one. 


The display will “wrap around" if you go beyond the first or last 
column or row. For instance, a "K" will advance you from the 
last column of one row the first column of the next row. 
Similarly, an "M" will advance you from the last row of one 
column to the first row of the next column. Also "K" or "M" will 
advance you from the lower right corner to the upper left one. 
"J" and "I" always move you in exactly the oposite direction as 
pi Cl and "My". 


X-LEAVE INTERACTIVE MODE 


When you key "X" PLAN80 will execute the statement following the 
INTERACTIVE statement. 


!-QUIT CURRENT FILE 


When you key "1" PLAN80 will leave the currently active text 
file. This code is normally used to escape from a "REPEAT" loop. 


#-EXIT PLAN 80 


Key "#" to leave PLAN80. This code is often used when you want 
to leave PLAN80 and edit an input file. 


The latter two commands require that you press the SHIFT key in 
additon to the "1" and "3" keys respectively, substantially 
reducing the chance that you will accidentally exit the 
interactive mode and lose the values you have input. 
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THE "REPEAT" STATEMENT 


un came GED Gmw Gow tne eum Un GED GUS ES) me Ge GUD GO GED GINS ENSD GED OUND GED ERP OOD GAN Ble GS GND ED GED GOW GLP GH ewe GENS Sue Ge” GD GD Gay Gee EON EOE) GEE Exe EIN CoD EoD Ge GED GE GS Gow ae GAS Gl Gon Gm GE Em EEE Ge CoD Gun THe SES 


The format of the REPEAT and INCLUDE statements is identical. 


sREPEAT "<filename>" 


The REPEAT statement includes external PLAN80 statement files as 
does the INCLUDE statement. REPEAT, however, continues to include 
the named file until either the "Q" or "E" options are used to 
leave either the INTERACTIVE or DISPLAY modes. 


HOW “REPEAT” IS USED 


A file included by a REPEAT statement will nearly always contain 
an INTERACTIVE statement (and usually a DISPLAY statement). You 
can then change values interactively, recalculate and display (or 
print) results. REPEAT, in essence, makes the named file behave 
as though it were an endless.loop. The following diagram shows 
the structure of an application using REPEAT. 


| titles | 
| columns | 
| rows | 
| data eee Se 
| repeat ee cee ee | interactive | 
ae ee | rules 
| display | 
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A "RULES" SECTION 


Rules, or calculation statements, must occur within a rules 
section headed by : 


:RULES 
Rules contain 

* a row or column name, 

* an equals sign "=", and 

* a PLAN80 expression. 
Fach rule must begin on a new line but may continue on subsequent 
lines. The last character of a line to be continued must, 
however, be a mathematical operator (+,;-,*,/ or “). 


A PLAN80 application may have any number of rules sections. 
SOME EXAMPLES 


The following are indicative of valid PLAN80 rules: 


ROW14 = ROW9 + # £4ROW13 

ROW26 = ROW16 * @SUM(ROW17..ROW25) 
PRODA = TOTAL - @MAX(DEMAND1,FACTOR3) 
LINES = @SIN(@LN(LINE3) ) 


TWOLINE = ROW66 + ROW76 - 
31 * (ROW23 - ROW18) 


ROW RULES AND COLUMN RULES 


To understand just how rules operate in PLAN80 let us use a 
checkerboard with the following initial values: 


COLA COLB  COLC 


ROW] | 7S | 10 | 0 | 
a | er 8 
a a eae 
a 


If ROW4 was meant to be the sum of ROW1, ROW2 and ROW3 we could 
write the rule 


ROW4 = ROW] + ROW2 + ROW3 


which would calculate a total of 105 for COLA, 65 for COLB and 0 
for COLC. Similarly, we could write the rule 


COLC = COLA - COLB 


which would calculate 5 for ROW1, 10 for ROW2, 25 for ROW3 and 40 
for ROW4, based on the results of the first calculation, 


Note that the first rule is a row rule and that it contains no 
column names. Similarly the second rule is a column rule, and it 
contains no row names. Except when referring to the specific. 
Square on the checkerboard, as in @(ROW4,COLC), the names used in 
valid PLAN80 expressions must all be of the same type as the name 
preceeding the equals sign. Row and column rules may be freely 
intermixed as we did above, but any single rule will have only 
column names or only row names. 


Also you’ should note that a row rule applies to each and every 
column unless excluded by a FOR’ statement. Similarly column 
rules apply to each and every row unless excluded by a FOR 
statement. The FOR statement discussed in detail in Chapter 8. 


SOME BASIC EXAMPLES 
Let's continue the discussion of rules with another example which 
has data in ROW] only: 


COLA COLB COLC 


ROW] | 2 | 4 | Te 
mm aa 
oo 
ROw4 Bo Ose ere 


and consider the following rules: 


ROW2 = 3 
ROW3 = ROWlL * ROW2 
ROW4 = ROW] * 3 


NOTE: The first example looks like a data statement, but don't 
confuse data and rules statements. | 
The above rules would result in the following: 
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COLA COLB COLC 


ROW] | 2=| 4 | 7 | 
mee pay a 
ee er ee 
a Ce eee east 


The first rule replaces all values of ROW2 with the value 3. 
This is equivalent to the data statement . 


ROWZ\ == 3-3 3 


The second rule creates ROW3 by multiplying each value of ROW] by 
the corresponding value in ROW2. 


The third rule creates the same effect as the two previous’ rules 
combined. Each value within ROW] is multiplied by the number 3. 


RULES ARE NOT EQUATIONS 


It is permissable to use the row or column named as the answer in 
an expression on the right side of a rule. The rule 


ROWlL = ROW1l * 3 


would cause each value within ROW] to be replaced by a value 
three times the original value, and : 


ROW] = ROWl + ROW1l + # £=ROW] 


‘would be-a cumbersome but permissable way of achieving the same 
result. : 


MATHEMATICAL OPERATORS 


Rules may have names, single values such as "3", and expressions 
linked by the mathematical operators (+,-,*,/ and “~ for addition, 
subtraction, multiplication, division and exponentiation). Note 
that the asterisk "*" and not the character "x" is used _ for 
multiplication. The "*“" indicates that one value is to be raised 
to the power indicated by another. Thus ROW3°2 indicates that 
each value of ROW3 is to be multiplied by itself and ROW3%.5 
indicates the square root of each ROW3 value. 
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ORDER OF EVALUATION 


The expressions on the right side of a rule are evaluated from 
left to right. Thus 


ROW) = 3-"4"°6 7 2 


would result in the assignment of 4.5 to each column of ROWl. 
Parentheses may be used to alter the evaluation sequence as in 


ROWl = 3 + (6 / 2) 


which would result in the assignment of 6 to each ROW] value. 
PLAN80 always determines the value of an expression within 
parentheses before using it as a term of some other expression, 


In PLAN80 any number of parentheses may be used to control the 
order of calculations within a rule. You must insure, however, 
that, starting from the left, the cumulative number of closing 
parentheses is never greater than the number of opening ones. 


MATHEMATICAL FUNCTIONS 


In addition to the normal calculations involving values, row and 
column names and expressions within parentheses, PLAN80 provides 
a number of powerful mathematical functions, They are summarized 
below then described in detail. Note that all are prefixed with 
the "@" sign. : | 


@SUM - calculates the sum of groups of rows or columns 


@CUM - calculates the cumulative sum within a row or column 
@MAX - determines the largest of a list of values 

@MIN - determines the smallest of a list of values 

@ABS - determines the absolue value 

@SQRT  - determines the square root 

@INT - determines the integer portion of a number 

@FRAC - determines the fractional portion of a number 

@EXP ~ determines "e" (2.71828) raised to the value provided 
@LN ~- determines the natural logarithm 

@LOG - determines the log (base 10) 

@SIN ~- determines the trigonometric 

@cos = functions of angles 

@TAN - expressed in radians 


GASIN = determines the trigonometric arcfunctions 
 @ACOS - » (e.g., the angle in. radians whose 
@ATAN - function is the value provided) 
@LOOKUP - extablishes values based on table lookup 
@IRR - calculates the internal rate of return (e.g., the 


over time has a present value of zero) 
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discount rate at which a series of values discounted 


@SUM 
This function is used to add groups of rows or éclumne: For 
example, the rule 

ROW9 = @SUM(ROW1,ROW4..ROW7) 
is equivalent to 

ROW9 = ROWl + ROW4 + ROWS + ROW6 + ROW7 


assuming that ROWS and ROW6, and only those rows, occur between 
ROW4 and ROW7. 


In general any number of single names (as in "ROW1" above) or 
group expressions (as in "ROW4..ROW7") may be used within the 
@SUM function. | 


In the @SUM function only row or column names may occur, but the 
@SUM function may appear within expressions as in the following: 


ROW9 = @SUM(ROW1..ROW8) * 100 
ROW99 = @SUM(ROW1..ROW9) + @SUM(ROW51..ROWS9) 
ROW99 = 100 - @SUM(ROW91..ROW98) 

@CUM 


This function is used to calculate the cumulative sum of values 
occuring within a row or column. Thus, assuming data in ROWQ of 
10, 14 and 26, the rule 

ANSWER = @CUM(ROWQ) 


would result in row ANSWER's having values of 10, 24 and 50. 


@MAX 


This function determines the largest of a series of values and is 
used in the form 
ANSWER = @MAX(expl,exp2...expn) 


where expn is a row or column name or an expression enclosed in 
parentheses. Assume the following values: 
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COLA  COLB COLC 


now)... Sy ae 
| Henne nen ene | 
powe  |..-4@1-8 4 5 4 
|-------------------- 
ore oe Oe 7 eae 


The following rules would result in the values shown: 


ROWX = @MAX(ROW1,ROW2) * 18. 46 a5 

ROWY = @MAX(0,ROW2) a ee 

ROWZ = @MAX((ROW1-ROW2),ROW3) = 8 10 20 
@MIN 


This function has the same format and can be used in the same 
Situations an @MAX, except that it determines the minimum of the 
values provided. 


The function @MIN(0,ROWX) may be used with @MAX to_ separate 
negative and positive values within a row or column. For 
example, if ROWX has the values -2, 0 and 10 then 


ROWA = @MAX(0,ROWX) will result in 0 0 10 and 
ROWB = @MIN(0,ROWX) will result in -2 0 0 


@LOOKUP 


The lookup function is used for problems where it is difficult or 
impossible to develop a mathmatical expression which relates the 
value of one number to another. For example, consider a set of 
income tax rates. As income increases from one bracket to 
another, new rates become applicable. Other examples would 
include interest rates as a function of the size of a loan, 
prices as a function of quantity purchased, and overhead rate as 
a function of cost center number. : 


The lookup function has three parts as in the following example: 
ANSWER = @LOOKUP(INCOME,BRACKET1..BRACKET3,RATE1) 
The first part is INCOME in the example. Where it falls in the 


range of BRACKET values (the second part) will determine which 
RATE is selected (the third part). Consider the following: 
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COLA COLB COLC COLD 


INCOME | 2 | 6 | 20 | 100 ‘ 

oe st a 

eek ee | 
pO Seg ee ue See 
wea eo) ek ee 

wae ie ee ae 

Ae oe ae wate = 

a ao a ee 


For each column the row ANSWER has been determined by searching 
the rows from BRACKET] to BRACKET3 for the last row whose value 
is less than or equal to the value of INCOME. Then ANSWER is set 
to the value of the row whose rate value corresponds to _ the 
bracket value. For instance, in COLB the value of INCOME is 
greater than the BRACKET1 value, which causes the RATE] value to 
be assigned to ANSWER. In COLC the income value first equals or 
exceeds the BRACKET2 value, and the RATE2 value is assigned to 
ANSWER. Similarly in COLD, ANSWER receives the RATE3 value. (If 
there is no row with a value less than INCOME, as in COLA, then 
ANSWER is set to zero). 


The following guidelines, expressed in terms of the example 
Bpeve: must be followed in setting up lookup tables: 
If ANSWER is a row then the other three parts, income, 
brackets and rates, must be rows. ANSWER could, however, be 
a column, but then the other parts must be columns. 

* The brackets and rates tables may occur anywhere. Either 
table may preceed the other. 

* Within each table, however, all member rows or columns must 
be stored next to one another. In other words, no row, not 
part of the brackets table, may occur between BRACKET] and 
BRACKET3. Otherwise the row would be considered part of the 
bracket table. Similarly, no row, not part of the rates 
table may occur between RATE] and RATE3. 

* You must make sure that the rate table is the same length as 
the brackets table. Table length is implied by the number of 
rows or columns occurring between and including BRACKET1 and 
BRACKET3. 

* In the example above the row names for brackets and rates 
contained numbers. This is a useful technique, but not a 
necessary one. Any valid name may be used for table rows or 
columns. \ 
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@IRR 


This 
flows of alternative investments, 
internal rate of return, 
data on the computer screen or printer. 
as the answer (e.g. 


The idea behind this function is as follows: 


function is generally used to evaluate the 
The computed value, called the 
is calcualated and shown with the input 
The row or column named 
sign) 


appearing to the left of the equals 
will contain the discounted cash flow values. 


Investments 


projected 


generally characterized by an initial net outlay of cash and 


subsequent return of cash. Obviously the greater the _ total 
amount returned and the earlier it is returned, the more 
attractive the investment. But how should two investments 


evaluated if one provides larger returns per dollar invested, but 


at a later date? 


The 
present value 
outlays. Now, 
change in timing, 
balance 
the calculated internal rate of return, 
investment, all other factors being equal. 


@IRR function determines the discount rate that makes 
of future earnings equal to the value of 
the higher that future earnings are without any 

the higher the discount rate must be raised to 
future earnings with current outlays. Thus the 
the more attractive the 


The @IRR calculation 


is a good tool for ranking alternative investments, 


The @IRR function calculates the discount rate "r" 


in the follow- 


ing series where “cf(n)" indicates the cash flow of year "n"s 


0 = cf(1) + cf(2)/(1+r) 


OTHER MATHEMATICAL FUNCTIONS 


-- INPUT DATA -- Sei 2 Beg wipe Cae or eae neon ieee RESULTS, <~-=<<<-->< 
COLA COLB COLC Function COLA ~ COLB COLC 
-30 . - 20 @ABS 30.00000 - 20.00000 
100 200 300 @SQRT -10.00000 14.14214 17.32051 
-1.5 0,5 16.2 @INT -1.00000 - 10.00000 
-@1,5 0.5 10.2 @FRAC -0.50000 0.50000 0.20000 
0.5 1 ee @EXP 1.64872 2.71828 7.38906 
ae 10 100 @LN - 2.30258 4.60517 
0.1 1 10 @LOG -1.00000 - 1.00000 
0.5 l 2 @SIN 0.47943 0.84147 0.90930 
0.5 poe! 2 @cos 0.87758 0.54030 0.41615 © 
0.5. 1 2 @TAN 0.54630 1.55741 2.18504 
0.5 1 2 @ASIN 0.52360 1.57080 ghee. 
0.5 1 2 @ACOS 1.04720 - - 
0.5 1 2 @ATAN 0.46365 0.78540 1.10715 
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* O£(3)/(l¥r)"2 + 4 


The input data and functions below produce the results shown: 


cash 


are 


the 
current 


higher 


SINGLE DATA VALUES 


You may use single data values in any expression where you might 
use a number. Single data values are formed as follows 


@(row name,column name) 
The following would be valid rules using single data values: 


COL14 = COL13/@(ROW99,COL13) 
ROW6 = @MAX(ROW4,@(ROW5,COL11)) 


ASSIGNMENT OF SINGLE VALUES 


It is possible to assign values to a single checkerboard location 
as in the following: 


(ROW2,COL3) = 12.3 
(ROW6,COL9) = @(ROW3,COL11) 


Note that the term to the left of the equals sign does not use 
the "@" sign. Also note that expression on the right of the 
equals sign must reduce to a single value. Thus the following 
would be invalid: : 


(ROW3,COL5) = ROW 
LEADING MINUS SIGNS 


Any term appearing in an expression, including row or column 
names, data values or functions, may be preceeded by a minus sign 
to indicate that the quantity represented is to be treated as 
though it were to be multiplied by minus one. For example, the 
following reflect permissable use of leading minus signs: 


ROWA = —-ROWB 

ROWA = -(ROWC * -ROWD) 

COLA = -@MAX(COLF,COLG) 
SHIFTING OF DATA 


Consider a rule such as 
SALES = UNITS * PRICE 


If this is a row rule then every column will be treated 
independently of all other columns. We want most rules to act 
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this way. But there are some problems where we want to bring a 
value forward from a prior period and add it to or subtract it 
from a value of the current period. This requires a row rule 
that can operate on more than one column at a time, Shifting is 
what makes this possible in PLAN80. 


SHIFTING IN ROW RULES 


First, let's look at PLAN80's Cue 6 to shift aie starting 
with the following: 


COLA COLB COLC COLD 


ROW1 | 11 | a2 | 33 | 44 | 


| ss i cs sms Ga sc cs sas we a is eis Sou ses sna 
ROW2 | 0 | Ode. 2 0 | 
ROW3 | 0 | 0 | 0 | 0 | 
Row4 =| 0 | o | 0 | 0 | 


Within a row rule PLAN80 allows data to be moved from one’ column 
to another by adding a bracketed number at the end of any term or 
expression, The number provides the left or right direction, 
using the checkerboard analogy, for the source of data values. 
For example, look at the effects of the following rules: 


ROW2 = ROW] (-1) 
ROW3 = £ROW1(-2) 
ROW4 = #£ROW1(1) 

COLA COLB COLC COLD 
Se ae 
sere ee ars 
a a et ak oe 
powe | 22) a3) as TO 
SHIFTING IN COLUMN RULES 3 


Data may be similarly shifted between rows by column rules. For 
example, assume the following: 
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ROW] | ee ee 0 | 0 | 0 | 
eer an Poe eo 
ie ar Oo et 
POT Soe ety creer soe 


The following rules would produce the results shown: 


COLB = COLA(-1) 
COLC = COLA(-2) 
C€OLD- = COLA(1) 
COLA COLB COLC COLD 
ROW] | Le ee 0 | 0 | 22 | 
| ------------ ier ons pi ana i Ine 
ROW2 | 22° te 0 | Ce oe 
| Tics ic ts ih “ss eh sacs a Se esa ms ts iE ia gd Get cana 
ROW3 | 33 (| 22° "| ee ae 44 | 
| as aa Gain (Gi Gas Gan aes ne tows Sod es WS NSS ew a aw a as ea ea a we es 
ROW4 | 44 | a7] 22 i 0 | 


OTHER WAYS TO VIEW SHIFTING 


It may be helpful to consider a eal euladt ion such as’ 
ROW2 = ROW1 7 

as equivalent to 
ROW2 = ROW1(0) 

and to consider a calculation such as 


ROW2 = ROW1(-1) 


as equivalent to asking that PLAN80 move data from each previous 
column in transferring values from ROW] to ROW2. 


Another way of viewing the shift instruction is in terms of time, 
Assuming time progresses from COLA to COLB to COLC, etc., then 
ROWX (-1) indicates one period ago, 
ROWX indicates the present, and 
ROWX (1) indicates one period in the future, 
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THREE EXAMPLES OF SHIFTING 


Shifting is used frequently for cash flow and inventory problems 
because balances at the end of one period depend on those of a 
prior period. We will look at two cash flow and an inventory 
problem. 


CASH FLOW EXAMPLE #4 


Let's start with the following: 
Y1980 Y1981 Y1982 Y1983 Y1984 


INCOME | | 30 | 35 | 30 | 40 | 
seein | eo en ea ee fo 0 
pas | 20] a a7] 38 130 
— We Be ee ee. | 
CF2 | | | | | ! 
oes 


We will assume income is not complicated by taxes and that the 
ASSET and LIAB lines represent single lines from a balance sheet. 
You could think of them as inventories and accounts payable. In 
lines CF1l, CF2 and CF3 we will show the cash flow from each of 
the first thee lines. 


CURRENT PERIOD CHANGES 
Without taxes to worry about we can view income as a direct cash 
inflow. Thus 
CFl = INCOME 
reflects the fact that during each period one part of the total 


cash flow effect will be the that of income received. 


CHANGES BETWEEN PERIODS 


Calculating the cash flow effect for balance sheet items is more 
@ifficult than for an item such as income, because we are 
interested in changes between two periods rather then the 
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activity of one period. If, for example, an asset increases from 
one period to the next, then cash will be required to acquire 
this asset. Adopting the convention that cash outflows should be 
negative on the cash flow statement, the following rule may be 
used to calculate the cash flow effect of asset changes: 


CF2 = ASSET(-1) - ASSET - 
The liability account is handled in a similar way, only the sign 
must be reversed. When a liability increases you are increasing 
a debt to someone and this debt is a source of nae Thus you 
would use the following for a liablity: 

CF3 = LIAB -  LIAB(-1) 
We may now look at the effect of these three rules: 


Y1980 Y1981 Y1982 Y1983 Y1984 


INCOME | mee 20g) 9SA.. 02 40 
owe on ee 
cae A ee ee 
i 4 Se ee eee 
CF2 | - {> £10) 1 (8) | 6 | a 
spat i fe ee ee 


Note that we have put no values in the first column since the 
ASSET(-1) and LIAB(-l1) terms are undefined for that column, 


CASH FLOW EXAMPLE #2 


In the first example we assumed income had already been 
determined for each period before calculating cash flow. In this 
example we will let income for each period depend on the _ cash 
balance as of the end of the previous period. This means that we 
will now need to calculate both the income and cash flow for one 
period before calculating them for the next, 
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) 
, 


Assume the following: 


RATE ~—| 
REVENUE | 
EXPENSE | 
INCOME] | 
INCOME2 | 


CASHBAL | 100 


(INCOME2 , Y81) 
(CASHBAL , ¥81) 
(INCOME2 , Y82) 
(CASHBAL, Y82) 
(INCOME2 , Y83) 
(CASHBAL, Y83) 


(INCOME2 , Y84) 
(CASHBAL , Y84) 


Y80 
RATE = | - 
REVENUE | ~ 
EXPENSE | « 
INCOME] | - 
INCOME2 | “ 
CASHBAL | 100 


Y81 Y82 Y83 
Lod 2 
| 200 {| 240 | 300 
| 120 | 140 | 164 


is required for this 
INCOME] = REVENUE - EXPENSE 


Then continue as follows: 


This will result in the following: 


The problem may be handled in either of two ways. 


In the first approach you should break the 
sections. First, handle in general terms all calculations which 
do not depend on prior year values, 


problem into two . 


In the example only one rule 


@ (RATE, Y81) 


@(CASHBAL,Y80) * 
@(CASHBAL,Y80) + @(INCOME1,Y81) 
@(CASHBAL,Y81) * @(RATE,Y82) 
@(CASHBAL,Y81) + @(INCOME1,Y82) 
@(CASHBAL,Y82) * @(RATE,Y83) 
@(CASHBAL, Y¥82) + @(INCOME1,Y83) 
@(CASHBAL,Y83) * @(RATE,Y84) 
@(CASHBAL,Y83) + @(INCOME1,Y84) 
Y81 Y82 Y83 Y84 

i oe0 |. Gio | LO 10 

| a aa Bae es celts Gass ea seas ada as cae eee of es Bes as 
| 200 | 240 | 300 350 

| ene dei ee eras as a wn ees eo ee ed as 
L120) 146.1. 163 180 

| Gs Ge esse ses ln otc css geese ok tial eas maa Tag ca genet GAS [sss 
| 80 | 100 | 137 170 

| cscs sea Sa css Sass suas ns es ai ink ees nS seo 
| 20 | 30 | 33 50 

| i ac a cade cane ed es secs acct “ae cinneesncindA ia'gas “Scn Siwsaa 
| 200 | 330 | 500 720 


ol} 


> 


fe 


+. 


@ (INCOME2 , Y81) 
@ (INCOME2 , Y82) 
@ (INCOME2 , Y83) 
@(INCOME2 ,Y84) 


An alternative approach uses other PLAN80 facilities. First, set 
up a file which has 


: RULES 
INCOME] = REVENUE - EXPENSE 
INCOME2 = CASHBAL(=-1) * RATE 
CASHBAL = CASHBAL(-1) + INCOME] + INCOME2 


Save this file as "CASHCALC". Then create a main procedure which 
includes CASHCALC for each period as in 


: COLUMNS 

<columns> 
s ROWS 

<rows> 
:DATA 

<data> 
:FOR COLUMNS=(Y81) 
s: INCLUDE “CASHCALC" 
:FOR COLUMNS=(Y82) 
s: INCLUDE "CASHCALC" 
:FOR COLUMNS=(Y83) 
s INCLUDE "CASHCALC" 
:FOR COLUMNS=(Y84) ( 
: INCLUDE "CASHCALC" 
:DISPLAY 


The FOR and INCLUDE statements are covered in chapter 12. The 
FOR statement controls the scope of the rules, telling PLAN80 to 
procesS one year at a time in the above example. The INCLUDE 
statement tells PLAN80 to fetch a group of statements and process 
them as though they had been part of the file containing the 
INCLUDE statement. ; 


INVENTORY EXAMPLE 


Let us now look at how we might construct a projected inventory 
positon, a process that is somewhat the reverse of the cash flow 
example. In the cash flow problem we knew the projected balances 
and were interested in calculating the changes. In this problem 
the changes, production and shipments, will be known and we will 
be interested in computing the balances, 


Let's begin with the following values: 
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OPENBAL | 100 | eo | 
ee ree 
IB Cae aoe 2 | 28 | 
CLOSEBAL Pe ae meee | 


Now if we were doing the above problem manually we might 
calculate the MAY closing balance of 95 as with 


CLOSEBAL = OPENBAL + PROD —-— SHIP 
and then use a rule such as 
OPENBAL = CLOSEBAL(-1) 


to carry the 95 forward to the next period and repeat’ the 
process. This, however, involves switching back and _ forth 
between rules starting with MAY and then moving forward to JUN, 
JUL, etc. However, it is important that you understand that each 
row rule operates on all columns before moving to the next rule, 
and that each column rule operates on all rows before carrying 
out the next rule. Thus, to use this approach you must use the 
INCLUDE technique introduced in the second cash flow example. 


There is, however, an easier way to handle the inventory problem. 
The solution is to put the net changes into the CLOSEBAL line and 
accumulate them as follows: 


CLOSEBAL 
CLOSEBAL 


OPENBAL + PROD - SHIP 
@CUM (CLOSEBAL) 


The first rule would result in the following: 


OPENBAL | 100 | joe ee] 
PROD 0 | oe ete ae 
— Ca a ee 
CLOSEBAL bowen (eee @ ie 


and the second rule would change the last row to 


‘-CLOSEBAL 95 100 106 107 
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Finally the rule 
OPENBAL = OPENBAL + CLOSEBAL(-1) 


would complete the example: 


OPENBAL | 100 | 95 | 100 | 106 | 
ee ae oe 
ea a 
aii: | ge det ee ee 


DISPLAYING EACH RULE’S RESULTS 


Assume the following initial values: 


COLA COLB COLC: COLD 


If you place the word "SINGLE" after the word "RULES"  PLAN80 
will display calculation results when each rule is executed as in 


:RULES SINGLE 


ROW99 = ROW1 
10 12 ae 4 
ROW99 = ROWl * ROW2 


80-12. =21 8 
Each column's’ results are shown for row rules, and each row's 
results are shown for column rules. The number of values 
displayed or printed may be limited by putting a number inside of 
parentheses after the word SINGLE as in 
sRULES SINGLE(8) 


The system will pause after each rule until you press the space 
bar. You may leave the SINGLE mode by pressing the "X" key. 
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DISPLAY AND PRINT - AN INTRODUCTORY NOTE 


DISPLAY provides an interactive environment in which the user may 
scroll through the output on a computer screen and request 
printed output if and when desired. You would normally use the 
DISPLAY approach whenever you were viewing results on the screen, 
changing assumptions, etc., and then occasionally printing a set 
of results. 


PRINT is available for more structured jobs, such as for standard 
analyses performed each month, or in situations where many 
printed reports were desired. Unlike DISPLAY, PRINT does not 
operate interactively. Through the use of the OPTIONS feature 
you do have nearly the same control over printed output as you 
have in the DISPLAY mode. 


THE "DISPLAY" STATEMENT 


ee ee ee ee a ee ee ee ee ee ce eo ee en ee eee ee ee 0 ee Eee 


when the DISPLAY command is encountered the “DISPLAY COMMANDS” 
menu appears on your. screen, This menu shows the options 
available and their current values. Whenever an option value is 
changed the menu is updated to show the new current value. The 
menu is, of course, removed whenever results are displayed on the 
screen, but depressing any key will cause the menu to appear 
again. 


CONTROLLING WHAT IS DISPLAYED 


The computer screen may be thought of as a window which may look 
at any part of the matrix formed by all columns and rows. Using 


commands shown on the menu you may position the window at any. 


particular row and/or column and may scroll through the results 
in any direction. 


CONTROLLING HOW ITIS DISPLAYED 


You may also change the width of columns or the effective size of 
the screen or print page. And you have the option of having rows 
and/or columns identified by their names instead of their 
descriptions. These choices allow you to display the greatest 
possible amount of information on the screen at one time. — 
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THE “DISPLAY COMMANDS” MENU 


The "DISPLAY COMMANDS" menu is shown below and a desription of 
each command option follows. The numbers on the right indicate 
current values for each option. 


DISPLAY COMMANDS 


C - STARTING COLUMN NUMBER . 1 
R - STARTING ROW NUMBER .. 1 
I,J,K,M - MOVE UP,LEFT, RIGHT, DOWN 


- EXIT FROM “DISPLAY" 
- QUIT CURRENT FILE 
- EXIT FROM PLAN80 


1 - COLUMN HEADING OPTION . 2 
2 - ROW HEADING OPTION... 2 
3 ~- ROW DESCRIPTION WIDTH . 16 
& - COLUMN WIDTH e e© e@ e@ # @ 8 
5 - DISPLAY PAGE WIDTH ... 80 
6 - DISPLAY PAGE LENGTH .. 24 
7 - PRINT PAGE WIDTH ... .- 80 
8 - PRINT PAGE LENGTH .. . 56 
S - SET STANDARD OPTIONS 

D ~ DISPLAY 

P= PRINE 

xX 

! 

# 


INPUT CODE ~--> 


C-STARTING COLUMN NUMBER 


This choice allows direct input of the relative number of the 
first column to be shown on the screen. A number greater than 
the total number of columns will display only the last column, 
Row description information will always be shown no matter which 
column is first shown. The starting column is always 1] the first 
time that a DISPLAY command is encountered. 


R-STARTING NUMBER 


This choice allows direct input of the relative number of the 
first row to be shown on the screen, A number greater than the 
total number of rows will display only the last row. The 
Starting number is always 1 the first time that a DISPLAY command 
is encountered. 
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i, J, K, M-MOVE UP, LEFT, RIGHT, DOWN 


These four keys, arranged as follows, control scrolling: 

ILI 

ff IR 

MI 
and their position relative to one another is indicative of the 
effective direction. Up and down scrolling occurs in half page 
increments with "I" and "M", "J" and "K" cause scrolling right 
or left one column each time the key is pressed, If the DISPLAY 
COMMANDS menu appears when one of these keys is pressed, then the 
new starting column or row number is shown on the menu, 
Otherwise, these keys automatically cause results to be displayed 


as if the "D" key had been pressed following the _ scrolling 
command, 


4 - COLUMN HEADING OPTION 


On either the screen or printed report, columns may be identified 
by the three line descriptions or by the column names, The 
former is the standard option. The option may be changed by 
pressing "1" and then by responding to the prompt line 

INPUT COLUMN HEADING OPTION --> , 


with a "1" for names or a "2" for descriptions. 
2 - ROW HEADING OPTION 


On either the screen or printed report, rows may be identified by 
their descriptions, which may be any number of lines in length, 
or by their names, The standard option is the former, The 
option may be changed by pressing "1" and then by responding to 
the prompt line 


INPUT ROW HEADING OPTION --> 


with a "1" for names or a “2" for descriptions, 


bom 


Se 


3 - ROW DESCRIPTION WIDTH 


In printing or displaying lines such as 


SALES _ 100 200 oe « etc, 


PLAN80 places the words "SALES" AND "COST OF SALES" in a_ special 
column whose width is determined by this option. No matter how 
long the description line, only the number of characters, 
including blanks, given by this option will be shown. Thus, in 
reviewing intermediate results you may want to change this para- 
meter from its standard value of 16 to 8, for example, to display 
an additional column of numbers, The width may be changed by 
keying "3" and responding to the prompt line 


INPUT ROW DESCRIPTION WIDTH --> 


with any number between 0 and 40. 


4 - COLUMN WIDTH 


In printing or displaying results the standard width of columns 
is 8 characters. For numbers without decimal points this permits 
any value less than 10 million to be displayed, and for others it 
allows six significant digits to be shown. The width option may 
be changed by keying "4" and responding to the prompt line 

INPUT COLUMN WIDTH --> 


with any number between 4 and 20. 


5 - DISPLAY PAGE WIDTH 


The standard value of this parameter is 80, the width of many 
computer screens. The value may be changed by keying "5" and 
responding to the prompt line 

INPUT DISPLAY PAGE WIDTH <--> 


with any number between 20 and the physical screen width. 
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6 - DISPLAY PAGE LENGTH 


The standard value of this parameter is 24. The value may be 
changed by keying "6" and responding to the prompt line 


INPUT DISPLAY PAGE LENGTH <=> 


with any number between 6 and the physical screen length. 


7 - PRINT PAGE WIDTH 
The standard value of this parameter is 80. The value may be 
changed by keying "7" and responding to the prompt line 

INPUT PRINT PAGE WIDTH <--> 


with any number between 20 and the number of characters which 
your printer is able to put on a Single line. 


8 - PRINT PAGE LENGTH 


The standard value of this parameter is 56 which will provide 5 
lines at the top and bottom of a 1l" page at six lines per inch. 
The value may be changed by keying "8" and responding to _ the 
prompt line 

INPUT PRINT PAGE LENGTH --> 


with any number between 6 and 999, 


S - SET STANDARD OPTIONS 


Key "S" to set all options to their standard values. Starting 
column and row values are set to l. 


D - DISPLAY 


Key "D" to show results on the computer screen, The columns and 
rows shown and the width of columns, etc., are controlled by the 
options seen on the DISPLAY menu, 
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P - PRINT 


Key "P" to put results on an external printer, on your screen Or 
in a text file for subsequent viewing, editing and/or printing. 
Printed results include titles, underlining and spacing which is 
ommited when results are displayed. You will be asked 


INPUT DESTINATION --> 


You may enter the name of any output volume such as "PRINTER:", 
"REMOUT:" or "“CONSOLE:", or you may enter a file name such as 
"DISKA:REPORT14.TEXT" and your report will be written to disk. 


If you do not provide a diskette name or volume number your file 
will be placed on the diskette whose name equals the prefix. 
value. If you enter the name of an existing file then it will be 
replaced by the new file. When printing to disk you will see and 
hear nothing for about 10 seconds. Then your disk will go on and 
off. This pattern will repeat several times for a short report 
and may require several minutes for a long report. 


If you press only the RETURN key the output will automatically go 
to CONSOLE:. You may want to do this to see how your printed 
report will appear before actually printing it. 


If any error is detected, such aS no more space on a_ diskette 
then you will hear a warning bell and subsequent output will 
appear on your console, : 


You may use CTRL-S to stop printing, particularly on your screen, 
There is a two second delay after each page printed on -the 
screen which gives you ample time to halt the display. 


You may press the RETURN key twice to leave this option without 
printing anything. 


The columns and rows shown and the width of columns, etc., are 
controlled by the options whose values are shown on the DISPLAY 
menu. When results are printed you should insure that the 
STARTING COLUMN and ROW values are those desired. In scrolling 
through results on the screen these values may have been changed. 
Columns and rows preceeding the starting values, as represented 
by the cross-hatched area in the following diagram, will not be 
printed, 
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starting column 


In the above example any rows or colums preceeding the starting 
ones would not be shown, but the remaining ones would be divided 
into as many physical pages as necesary, as explained in the 
PRINT section. This feature is helpful when the first few 
columns or rows are used for storing intermediate results and are 
not desired as part of the output results. 


X - EXIT FROM “DISPLAY” 


Keying "X" causes PLAN80 to leave the DISPLAY mode and to 
continue with the first statement following the DISPLAY command. 


1! - QUIT CURRENT FILE 


Keying "!" causes PLAN80 to leave the current procedure file. 
You normally use this option when you want to leave your current 
application and run another one or leave a REPEAT loop. 


# - EXIT FROM PLAN 80 


If you key "#" you will leave PLAN80 and will see the Language 
System's COMMAND prompt line. 


MISCELLANEOUS 


Each DISPLAY option value remains in effect until changed, from 
the DISPLAY menu or through an OPTIONS command or until you leave 
the PLAN80 system. 
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THE "PRINT" STATMENT 


Printed output may be obtained by using the "P" option of the 
DISPLAY command or from using the PRINT command as in 


:PRINT (<limits>) "<output destination>" 
EXAMPLES 


:PRINT 
:PRINT "FILE21. TEXT" 
:PRINT "JOB12:FILE4.TEXT" 
\ sPRINT (10,23,2,6) "REMOUT:" 
:PRINT (SALES,NET,P01,P10) "PRINTER:" 
:PRINT (1,999,F1981,F1983) 


LIMITS 


\ 


The limits field is optional and indicates the first and last 
rows and columns which are to appear on a printed report. You 
automatically will get all rows and all columns printed if you do 
not use this field. The format of this field is (rl,r2,cl,c2) 
where rl and r2 represent the first and last rows and cl and c2 
the first and last columns to be printed. If used the field must 
contain four values within parentheses in the order shown. Each 
row or column indicator may be either a name or number as in the 
examples above. If you use an invalid name or number rl will be 
set to the first row, r2 to the last row, cl to the first and c2 
to the last column. 


OUTPUT DESTINATION 


The output destination is also optional and if used must be in 
quotes. It may be the name of any output volume such as 
"PRINTER:", “REMOUT:" or "CONSOLE:", or it may be a file name 
such as "DISKA:REPORT14.TEXT" and your report will be written to 
disk, If not provided the output destination will be CONSOLE:. 


If you provide a file name but not a diskette name or volume 
number your file will be placed on the diskette whose name equals 
the prefix value. If you enter the name of an existing file then 
it will be replaced by the new file. When printing to disk you 
will see and hear nothing for about 10 seconds. Then your disk 
will go on and off. This pattern will repeat several times for a 
short report and may require several minutes for a long report. 
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MULTIPLE PAGE PRINTOUTS 


When reports are printed PLAN80 automatically formats them into 
as many pages as are required to show all columns and rows 
(except those excluded because of a "X" in their print control 
field). For instance, an application using 20 columns and 50 
rows might require three physical pages to handle the width and 
two to handle the length, or a total of six pages. The order of 
the pages would be as shown in the following diagram: 


Columns Columns _ Columns 
1-8 9-16 17-20 
Rows 1-30 | Page 1 | Page 2 | Page 3 | 
| | | 
| ---------- | --------- - |---------- | 
Rows 31-50 | Page 4 | Page 5 Page 6 | 
| 


In applications with large numbers of rows and columns you have 
the option of specifying where page breaks will occur or PLAN80 
will automatically create them using prevailing values for row ) 
description width, column width and page width options. 


Standard -assumptions. for PLAN80 are 16 characters for row 
description width and 8 characters for column width. Thus, a 
page, 80 characters wide, would hold 8 data columns. If column 
width were reduced to 7 or 6 characters then the total number of 
columns which would fit on the page would increase to 9 and 10 
respectively. 


Nonstandard values for column width, page width, page length, 
etc., are introduced using the OPTIONS command. 
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THE "OPTIONS" 


STATEMENT 


The OPTIONS statement includes the word OPTIONS and one or more 
parameters which may be separated by blanks or line breaks as in 


sOPTIONS STANDARD 


or 


:OPTIONS 


PAGEWID (100) 
PAGELEN (60) 


OPTIONS parameters ‘override standard values for row description 
width, column width, page length, etc. Many option values may be 
changed in the DISPLAY mode, but OPTIONS allows you to. conrol 
output appearance without operator intervention. 


OPTION PARAMETERS 


STANDARD 


COLNAMES | 


COLDESC 


ROWNAMES - 


ROWDESC 


ROWWID (n) 


COLWID (n) 


PAGELEN (n) - 


PAGEWID (n) - 


Sets the following parameters to their standard 
values. 

Sets column description option to print one line 
names instead of three line descriptions. 

Sets column description option to print three line 
descriptions. This is the standard option. 

Sets row description option to print names instead 
of descriptions. 

Sets row description option to print descriptions 
instead of names. This is the standard option. 
Sets row description width to n as long as Nn is 
between 0 and 40. Standard value is 16. 

Sets column width’ to n as long as nis between 4 
and 20. Standard value is 8. 

Sets page length to n as long as n is between 6 and 
999. Standard value is 46. 

Sets page width to n as long as n is between 20 and 
140. Standard value is 80. 
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PUT AND GET - AN INTRODUCTORY NOTE 


PUT and GET statements are used to communicate values from one 
PLAN80 application to another. The PUT statement causes results 
to be written to diskette, and the FOR statement controls just 
what portion of the results are saved, The GET statement causes 
saved results to be included, and the FOR statement controls how 
saved values are assigned. | 


\ 
THE "PUT" STATEMENT 


The PUT statement has one parameter, a file name, which must be 
in quotes. 


:PUT "<filename>" 


The PUT statement saves PLAN80 results on disk for use by another 
PLAN80 application, For example, one application may create a 
sales analysis by product and save the results of each sales 
district for subsequent preparation of a summary. report. A 
similar approach might consolidate financial statements or cost 
center budget and expense data. 


The following examples should clarify the PUT and GET process, 
In this example all Unit A and Unit B values are saved and 
subsequently consolidated. 


| COLA COLB fTOTC | | | 
| ROW1 10 20 30 | | ROW1 2 8 13 | 
| ROW2 15 25 40 | | ROW2 12 16 28 | 
| TOTR 25 45 70 | | TOTR 17 24 41 | 


ROW2 27 41 6 
TOTR she 69 lil 


| 
| ROW] 15 28 4 
| 
| 


OW 


In the following example one PLAN80 planning application is used 
for sales and another for expense. Summary results from each are 
then used by a third application for summarizing the plan: 
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| time --> | | time --> | 
| Details | | Details | 
| ee0e | | eoce ; | 
| eee | | eee | 
eee ge Le eee a oe ee a a ee 
| | Summary } | {| | Summary as ee 
we eos SS ee Se I | 
ere | = See | | 
ll Soars aaa | ba, 2a = 
| | 
Summary | 
Bee: a cane Sienna | 
ot | time --> | | 
| Sn Seo pe | 
[ | Sales ‘| | 
oeee | | eee | i | 
o 25 See | | 
ies Sees eS = el | 
| | Expense 1 | | 
ee ae ne Li 1 —=ee= 
ae eee = 
wie a oe ae eae |- 
| P&L | 
| [ 
| | 


In this example only a few values from each application are 
transferred to the summary. 


Through PUT and GET statements PLAN80 allows you to send any 
portion of the values of one application to another. 


USE OF THE “FOR” STATEMENT 


The FOR statement, whose construction is explained in Chapter 8, 
controls which rows and/or columns are communicated between 
PLAN80 applications. 


To understand more thoroughly what the FOR statement does let us 
consider the following example: : 


a Ce 


COLA COLB COLC COLD COLE 


ROW] | | | | 
ROW2 | | | | | 
ROW3 | | a | | | 
ROW4 | | | fg | 


ROWS | (. | | | | 


The FOR statement allows any number of <rows or columns to be 
ignored during the PUT process. Those columns and rows’ not 
ignored appear in the same order that originally prevailed. 
Thus, if COLE, ROW1l and ROW3 were ignored, then the following 
rows and columns would be included. 


COLA COLB COLC COLD 


Note that the data saved looks just as though it came from an 
application that was somewhat smaller than the original, and that 
the remaining values are in the same order as they were 
originally. It is as though you cut out strips representing rows 
and columns and slid the remaining pieces together. 


THE "GET" STATEMENT 


The format of the GET statement is 
:GET "<filename>" [mode] 


The name of the file that PLAN80 is to get must be in quotes and 
it must have been saved previously by a PUT statement. 


The mode is optional and may be any of the following: REPLACE, 
ADD, SUBTRACT, MULTIPLY or DIVIDE. No quotes should be used. 
The default value is REPLACE, which means that any value assigned 
will replace any existing value. In a consolidation you would 
specify ADD so that each new value would be added to any existing 
value, 


The other modes are useful in solving certain complex modeling 
problems. For example, MULTIPLY may be used for scaling standard 


oO = 


sets of values, or patterns of 0 and 1 may be used as switches in 
turning various alternatives off or on. 


HOW “GET” GETS 


Getting data is somewhat more complicated than putting, because 
the number of columns or rows saved previously may be different 
from the number of rows and columns of the application containing 
a GET statement, PLAN80 handles this situation by ignoring 
values that do not "fit" in the current column and row structure, 
The following examples should clarify what is meant by "fit". 


Assume that the PLAN80 application which contains the GET 
statement has the following columns and rows: 


COLI COL2 . cOL3 
ROW] j eee erie 4 ee | 
ROW2 | | | | 
ROW3 | | | | 


ROW4 || | | | 


In this case the single value would go to the cell bounded by 
COL1 and ROW1 since they both occur first, Also there would be 
no effect on any value other than the one at COL1 and ROWI1. 

If the saved values were of the form 


COLA COLB COLC COLD 


then ROWA would be assigned to ROW], because ROW] is the first 
available row. COLA through COLC would be assigned to COLI1 
through COL3. COLD would be ignored because the number of 
columns in the saved data is greater than the number of columns 
in the current application. 


Similarly with saved data of the form 


- 75 = 


COLA COLB 


ROWA | | | 
ROWB | | | 
ROWC | | | 
ROWD | | 


ROWE | | | 


COLA and COL1 would correspond as would COLB and COL2. ROWA 
through ROWD would correspond to ROW] and ROW4, and both values 
in ROWE would be ignored. In the assignment process there would 
be no effect on any value in COL3. 


In each of the above examples the ROWA,COLA value was assigned to 
the ROW1,COL1 cell and other column and row values were assigned 
in the order of their occurance, 


USE OF THE “FOR” STATEMENT 


Just as the FOR statement can make the sending application (the 
one with the PUT statement) appear smaller than it actually is, 
it can do the same to the receiving application. Once the FOR 
statement has reduced the apparent size of an application, the 
assignment of data occurs in exactly the same manner as with the 
examples discussed above. 
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THE "INCLUDE" STATEMENT 


The format of the INCLUDE statement is: 
: INCLUDE "<filename>" 


The filename must be the name of a file containing valid PLAN80 
statements, and it must be in quotes. Use of the ending ".TEXT" 
is optional. 


The INCLUDE statement allows PLAN80 statements to be placed ina 
file external to an application and is useful when: 
* a common. set of column or row definitions are used for a 
number of applications, 
* alternative sets of data assumptions have been created and 
are to be processed by one application, or 
* long production runs, involving many PLAN80 applications, 
are to run without operator intervention. 


The first statement of an included file must be a control 
statement. It may be preceeded only by comment statements. 


There is no restriction on the number of files which one file may 
cause to be included. For example, one file could call a number 
of others as follows: 


: --- MONTHLY SUMMARIES --- 
: INCLUDE "JOBO1.TEXT" 
: INCLUDE "JOBO2.TEXT" 
:INCLUDE "JOB99.TEXT" 


In addition each of the included files could include other files. 
For example, JOBO1 might be constructed as follows: 


: =--- "JOBO1]. TEXT" 

: INCLUDE "COL0O1.TEXT" 
:INCLUDE "ROW01.TEXT" 
:INCLUDE "DATO1.TEXT" 
: INCLUDE "RULO1. TEXT" 
s DISPLAY 


Generally you will find that even the most sophisticated 
applications rarely require more than two levels of included 
files, as in the examples above. Each level reduces the maximum 
possible size of an applicaton. 


You must make sure that an included file never tries to include a 
file which caused it to be included. Circular references will 
bring PLAN80 to a halt and you will have to press the RESET key 
befor correcting your PLAN80 input. 
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THE "FOR" STATEMENT 


FOR statements begin with the word FOR and include a column 
and/or row limiter. Both limiters are optional and may occur in 
either order. Either may start on a new line or appear on the 
same line as the FOR. 


EXAMPLES 


:FOR COLUMNS=ALL ROWS=ALL 

:FOR COLUMNS=(COLA..COLF,COLH) 

:FOR ROWS=(ROW1 , ROW3 , ROWS) 

:FOR COLUMNS=ALL ROWS=ALL EXCEPT (ROW8..ROW12) 

:FOR COLUMNS=(COLA..COLX) EXCEPT (COLG,COLP) 
ROWS=(ROW1..ROW17) EXCEPT (ROW7..ROW9) 


COLUMN AND ROW LIMITERS 


Limiters have the following format: 


COLUMNS = (included columns) EXCEPT (excluded columns) 
ROWS = (included rows) EXCEPT (excluded rows) 


The EXCEPT and enumeration of excluded columns or rows are 
optional. In place of the enumeration of included columns or 
rows may be the word ALL which is not placed in parentheses. 


In enumerating the included or excluded columns and rows you may 
either specify individual names as in 


(ROW1 , ROW2 , ROW3 , ROW4 , ROW9) 
and you may specify ranges as in 
(ROW1. . ROW4, ROWS) 
The previous two examples are equivalent if ROW2 and ROW3 are the 


only rows occurring between ROW] and ROW4. Individual names may 
appear in any order, but they must be separated by commas, 


USE OF “FOR” STATEMENTS 


The principles of the FOR statement have been covered in the 
sections covering DATA, RULES, PUT and GET statements. You may 
find it of value to study those sections again. The purpose of 
FOR statements is to cause PLAN80 to ignore selected columns 
and/or rows. 
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You can enter data into a specific row or column as in 


:FOR COLUMNS= (JUNE) 


:DATA 
SALES = 268.3 
costs = 121.9 


where SALES and COSTS are row names. Also the FOR’ statement 
might cause quarterly subtotal columns to be skipped as in 


sFOR COLUMNS=(JAN..MAR,APR..JUN,JUL..SEP,OCT..DEC) 

:DATA 
SALES 
COSTS 


100 110 108 “117 98 - ete, 
60 66 65 70 59 ete. 


FOR statements may be used in the RULES mode to limit the action 
of calculations to a subset of the columns or rows. For example, 
assume actual sales data for two years is input directly and that 
future year sales data are calculated from values in other rows. 


:DATA 
SALES = 100 110 


:FOR COLUMNS=(YEAR3..YEAR6) 
: RULES 
SALES = UNITS * PRICE 


Without the FOR statement the actual values 100 and 110 would 
become undefined, forcing you to input them after the future year 
‘calculations. 


With PUT and GET it is easiest to think of the FOR statement as 
excluding columns and/or rows prior to saving or recalling 
values. PLAN80 then behaves, in both the PUT and GET modes, as 
though the actual application had been defined originally without 
the excluded columns or rows. 
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AREMINDER | ne 


Once columns or rows have been ignored because of one FOR state- 

ment, they will be ignored indefinitely until another recognizes 

them. Thus, you must generally include a second statement as in 
sFOR COLUMNS=ALL 

Or 


:FOR COLUMNS=ALL ROWS=ALL 
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A powerful tool for 
planning and analysis 
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LICENSE AGREEMENT 


l. License, The individual purchasing this software is granted 
a nonexclusive license to use the software described in this 
manual, 

2. Copyright. This document is copyrighted and all rights 


reserved. No portion of this document may be copied or 
reproduced in any form without written permission from Business 
Planning Systems, Inc. Subject to the restrictions noted below 


you may copy nonprotected portions of the software for backup use. 
only, provided that you reproduce all copyright notices on such 


copies, . 

3.. Restrictions on Use and Transfer. The original and any 
backup copies of the software are intended for your personal use 
in connection with a single computer. You may not distribute 


copies to others without obtaining a Software Distribution 
License from Apple Computer Inc. for that purpose. 
4, Changes. Business Planning Systems Inc. and Apple Computer 
Inc. reserve the right to change the products described in this 
manual at any time and without notice. 

5S  DASCIAIMEL . Apple Computer Ince, and Business Planning 
Systems Inc. make no warranties, either express or implied, with 
respect to the software described in this manual, its quality, 
performance, merchantability or fitness for any particular 
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PURPOSE OF PLAN80 


PLAN80 is a powerful tool for significantly improving the quality 
and timeliness of plans, forecasts, budgets and analyses through 
the automated preparation of polished reports on a computer 
screen or printed page. 


SCOPE OF THIS DOCUMENT 


"The PLAN80 Tutorial" teaches you step by step everything you 
need to operate PLAN80 on an Apple II computer equipped with the 
Apple Language System. You will use the Language System's 
outstanding Editor to input and maintain files of  PLAN80 
statements, just as if writing a letter on your computer. And 
you will use the Language System's Filer to copy, delete, and 
rename files, etc. The Tutorial also includes sample PLAN80 
applications and error codes. 


SCOPE OF THE COMPANION DOCUMENT 


"The PLAN80 Language" teaches you to use PLAN80 for a broad range 
of planning and analytical problems. PLAN80 lets you in concise, 
easy-to-understand terms 

describe a problem's framework in terms of rows and columns, 
* input data values, 

* specify calculations, 

* display and/or print results, and 

* communicate results between PLAN80 -applications. 


+ 


HOW TO PROCEED / 


Read the first two chapters of "The PLAN80 Language”. Then skim 
the others. You'll have a good overview, and find it easy to use 
the manual subsequently as a detailed reference. 


Learn to operate PLAN80 from "The PLAN80 Tutorial", and use the 
examples in Appendix A as a pattern for your own applications. 


PLAN80 should increasingly help you fulfill your potential as an 
imaginative problem solver by eliminating the drudgery of 
manipulating numbers and presenting results. 


ORGANIZATION OF THIS MANUAL 


Chapter 2 discusses the equipment you need to operate PLAN80. It 
also discusses other equipment which you might want to purchase 
and its compatability with the PLAN80 system. 


Chapter 3 tells you how to start up your system, make diskette 
backup copies, determine the contents of your diskettes and copy, 


delete and rename files. Most of the procedures introduced in 
this chapter use a facility of the Apple Language System called 
the Filer. This manual introduces you to itS more important 


features. After you understand these you will probably want to 
study Chapter 3 of the APPLE PASCAL Operating System Reference 
Manual, which discusses other features. 


Chapter 4 tells you how to operate the PLAN80 examples provided 
with your PLAN80 system. 


Chapter 5 tells you how to’create and modify PLAN80 applications 
using the Editor, another facility of the Apple Language System. 
You will learn the more important commands, but will eventually 
want to study Chapter 4 of the APPLE PASCAL Operating System 
Reference Manual, which covers other Editor features. 


In learning about your computer and PLAN80 there is no substitute 
for hands-on experience. Sit at your Apple and go through each 
step of chapters 3-5. Fach step will add to your understanding, 
preparing you for subsequent steps. 


Appendices provide additional materials. Appendix A explains 
each of the examples provided with PLAN80. Appendix B_ includes 
procedures supporting chapters 3, 4 and 5. Appendix C contains a 
summary of the Editor commands presented in Chapter 5. Appendix 
D covers the messages produced when PLAN80 detects an error, and 
Appendix E discusses diskette space and memory limitations. 


CHAPTER 2 


BEFORE YOU START 


What You Will Need 
Compatability with Other Equipment 
Disk Drives 
Printers 
External Terminals 
80-Column Cards 
Installation of Equipment 
Use of the Words "Enter" and "Key" 
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WHAT YOU WILL NEED 


Before operating PLAN80 you will need 

an Apple II computer with the Language Systen, 

* at least one disk drive and controller, 

* a video monitor or television, 

* the APPLE3: diskette provided with the Language System, 
* the PLAN80: diskette which contains the PLAN80 system, 
* 
* 
* 


* 


the DEMO80: diskette which includes PLAN80 examples, 
at least four blank diskettes, and 
this manual and its companion, The PLAN80 Language. 


COMPATABILITY WITH OTHER EQUIPMENT 


Other equipment such as the following are welcome additions to 
your system and should be fully compatible with PLAN80. 


DISK DRIVES 


One drive is adequate for most PLAN80 applications, but a second 
is desirable, particularly for large applications. In some 
instances a hard disk might be useful. Currently 8" hard disk 
drives whose capacity is 10-20 million bytes (vs 140,000 for each 
Apple drive) are available and smaller 5" drives with a capacity 
of 5-10 million bytes should soon be available. Also it is now 
possible for a number of computers, connected to one hard disk 
drive, to share a common data base. Appendix E discusses space 
considerations. 


PRINTERS 


PLAN80 may be operated without a printer, but you will want’ to 
obtain one in the near future. Your dealer can show you a range 
of printers offering good to superior print quality and slow to 
high print speeds. Preparation of multi-page reports is easier 
with a printer that responds to a form-feed character. The Apple 
Silentype, for example, is very capable and reasonably priced. 


EXTERNAL TERMINALS 


With a monitor or television PLAN80 will display lines that are 
actually 80 characters wide, however, you must press a particular 
key sequence (control-A) to switch back and forth from the first 
40 columns to the other 40. An external terminal can provide a 
full 80 character screen as well as lower case characters. 


PLAN80 will work with any terminal which lets you place the 
Cursor anywhere on the screen and which has an "erase to end of 
line" and "erase to end of screen" capability. Most popular 
terminals have these capabilities. 


If you do use an external terminal you should eonnect it  to-~a 
Communicatons Interface Card (not a Serial Interface Card) which 
is plugged into slot 3 of your computer. Then you must operate 
two programs described in the section "SYSTEM RECONFIGUATION" of 
the "APPLE PASCAL Operating System Reference Manual". These 
programs will help you change the files SYSTEM.PASCAL and 
SYSTEM.MISCINFO on your APPLEO: or APPLE1: diskette. - Also you 
will need to put these new files on the PLAN80: diskette copies 
which you will be instructed to prepare in the next chapter. 


80-COLUMN CARDS 


An alternative to the external terminal is a card that plugs into 
slot 3 of your computer and which makes your screen behave as 
though it were an external terminal. Available cards also 
provide lower case characters. The quality of the display may 
not be as good as that of an external terminal, but the cost is 
much less. Also these cards are easier to install than external 
terminals. . ee 


INSTALLATION OF EQUIPMENT 
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Installation of the Language System is described in the 
publication "APPLE LANGUAGE SYSTEM Installation and Operating 
Manual", Your equipment should be connected and tested with the 
Language System prior to running PLAN80. If you are uncertain 
about your equipment or installation of the Language System then 
contact your Apple dealer or someone qualified to get you started. 


USE OF THE WORDS "ENTER" AND "KEY" 


The word "enter", as used in this manual, means to press a series 
of keys. At any point you may use the left arrow key to delete 
one or more characters typed in error. You tell the computer to 
continue by pressing RETURN. 


The word "key" means that you should press the key(s) indicated. 
The computer will respond immediately. You do not press RETURN. 


Note: In this manual you will be told to enter data which is 
included in quotes as in Enter "PLAN80:". You should never enter 
the quote marks unless specifically told to do so. 


CHAPTER 3 


GETTING STARTED 


es ec ec Ss tcc in cess RY, es asin mis asin Sen eshte Saws - sine kw casi Gime GR enn oy Nin“ Ns cake “tesla | th eg nb Sasa pm Satna Tens) in ee ae [A oe: Sees | ene, ino a wee Sree) at aoa eee Sew ae eee 


10 What You will Learn in this Chapter 
10 Booting the Language System 

11 Introducing the Filer 

IZ The Concept of Volumes 

LZ A Few Explanations 

13 Looking at a Diskette's Contents 
13. Copy Protection 

14 Formatting Blank Diskettes 

14 Executing the Formatter 

15 - Copying a. File 

15 With A Single Drive:System 

16 With a Multiple Drive System 
16 Now Copy Other Files 

17 Renaming a Diskette . 

17. Copying an Entire Disketté 


id With a Single Drive System 

18 With a Multiple Drive System 
19 Now Make Copies of DEMO80: 

19 Some Additional Filer Procedures 
19 Renaming a File 

19 Deleting a File 

20 Crunching a Diskette 


WHAT YOU WILL LEARN IN THIS CHAPTER 


In this chapter you will learn how to boot, or start up, the 
Language System, and how to make backup copies of the 
distribution diskettes, PLAN80: and DEMO80:, which you should do 
before running the PLAN80 system. Also you will learn about the 
Filer which is a part of the Apple Language System. 


The Filer deals with files, which are physically separate groups 
of information stored on diskettes. You'll encounter three file 
types. "CODE" files are programs that tell your computer what to 
do, "TEXT" files contain information that humans can read, and 
"DATA" files contain information that ~only a computer can read. 


The Filer is a general purpose program which lets you: 

* transfer files from one diskette to another, 

* transfer text files to a printer or to the console screen, 

* determine what devices are attached to your computer, 

* determine what diskettes are in your disk drive(s) and 
what files are on a diskette, 

* delete diskette files, and 

* change diskette or file names, 


The Filer is discussed in greater detail in Appendix B of this 
manual and in still greater detail in chapter 3 of the "APPLE 
PASCAL Operating System Reference Manual", 


BOOTING THE LANGUAGE SYSTEM 


The PLAN80 system is distributed on a diskette labeled "PLAN80:". 
Place that diskette into the disk drive that is plugged into the 
first drive positon of the disk controller card installed in slot 
6 of your computer. Then turn on the power (or press RESET if 
the power is already on). 


In about 15 seconds you will see a reminder of the terms of the 
purchaser's agreement (shown on the next page) and will be asked 
if you and your computer are licensed to use PLANS80O. lf you 
answer yes ("Y") to each question you will see instructions for 
running PLAN80 beneath the following command line. But don't try 
to run PLAN80 yet. You need to learn more about the Filer first. 
COMMAND: E(DIT, R(UN, F(ILE, C(OMP, L(INK, X(ECUTE ... 
1. INSERT PLAN80 DISKETTE(S) 
Ze KEY Xk 


3. ENTER "PLAN80" 
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If you do not answer yes ("Y") to each question you wiil receive 
the following message and will not be able to run PLAN80. 


COMMAND: E(DIT, R(UN, F(ILE, C(OMP, L(INK, X(ECUTE .. . 
PLEASE DO NOT USE PLAN80 AT THIS TIME. 
In either of the above cases you will have "booted" the language 
system. ("Booting" is an expression which comes from the idea 
that the computer lifts itself by its own bootstraps to get 
started.) 
The reminder of the purchaser's terms appears as follows: 
PLAN80. VERSION 1.1 COPYRIGHT (C) 1981 
BUSINESS PLANNING SYSTEMS, INC. 
1. FOR EACH COPY OF PLAN80 PURCHASED 
ONE PERSON AND ONE SPECIFIC COMPUTER 
ARE LICENSED TO USE THE SOFTWARE. 


2. ANY LICENSED USER MAY OPERATE PLAN80 
ON ANY LICENSED COMPUTER. 


3. USE BY AN UNLICENSED PERSON OR USE ON 
AN UNLICENSED COMPUTER IS STEALING. 
PLEASE ANSWER (Y/N) : 
ARE YOU LICENSED TO USE PLAN80? 


IS THIS COMPUTER ALSO LICENSED? 


INTRODUCING THE FILER 
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Whenever the command line 
COMMAND: E(DIT, R(UN, F(ILE, C(OMP, L(INK, MARCHE aan 


appears at the top of your screen you may key "F" to call _ the 
Filer and in a few seconds you will see the Filer prompt line 


FILER? G, S,. Ny by By Cy Ty Dx QO 1C.2] 
You are now in the Filer. (And whenever the Filer prompt line 


appears you may key "Q" to quit the Filer and return to the 
command line.) 
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THE CONCEPT OF VOLUMES 


Any input or output device, including the screen, the keyboard, 
disk drives, printer, etc., is referred to as a volume within the 
Language System. To see what volumes are currently available key 
"vy" when the Filer prompt line appears. You will see at least 
the volumes numbered 1,2 and 4, 


VOLS ON-LINE: 
1 CONSOLE: 
SYSTERM: 
4 # PLAN80: 

5 <diskette name> 

6 PRINTER: 

7 REMIN: 

8 REMOUT: 

5 <diskette name> 
10 <diskette name> 
Age <diskette name> 
2 <diskette name> 

ROOT VOL IS - PLAN80: 

PREFIX IS - PLAN80: 


If you have additional disk drives, with diskettes inserted, you 
will see some of the numbers 5, 9, 10, 11 or 12. If you have a 
printer attached you will see it listed as either volume 6, 
PRINTER:, or volume 8, REMOUT:, depending on which slot in the 
rear of your computer contains your printer's interface card. 
Volume 1 is associated with the keyboard and screen which you are 
now using. You will use these numbers and the names shown on 
your screen almost anytime that you use the Filer or run a system 
like PLAN80 in the Language System environment. 


A_FEW EXPLANATIONS 


Volume numbers, volume names and diskette names are generally 
interchangable. For example, you may refer to your screen as #1: 
Or as CONSOLE:, and you may refer to a diskette in volume #4 by 
number as in #4: or by name as in PLAN80:. Volume #4 is also 
referred to as drive #4 and volume #5 as drive #5, etc. 


The "ROOT" volume is the name of the diskette used to boot’ the 
Language System. You always boot from volume #4. A second disk 
drive is generally volume #5. 


Files are located in the Language System by volume name or number 


and then by specific file name. If a reference to°a file dees 
not explicitly indicate volume name or number then the "PREFIX" 
value is used to provide this information. The prefix is set to 


the root volume name whenever you boot your system. 
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LOOKING AT A DISKETTE'S CONTENTS 


While still in the Filer let's look at the contents of the 
diskette PLAN80:. The Filer prompt line should be visible. 
Insert PLAN80:, if it's not already in your disk drive. Key "E" 
(for extended directory listing) and the computer will ask 


DIR LISTING OF ? 


Enter "PLAN80:" (including the colon) and you will see a listing 
similar to the following: 


PLANS80: 

SYSTEM. PASCAL a) 22-SEP-60 6 CODE 
SYSTEM.MISCINFO 1... @=MAY-79 47 DATA 
SYSTEM. EDITOR 47 24-SEP-80 48 CODE 
SYSTEM.FILER 26 18-SEP-80 95 CODE 
SYSTEM. LIBRARY 34 19-SEP-80 123 DATA 
SYSTEM.APPLE 32 9+NOV-80 157 DATA 
SYSTEM. STARTUP 10 27-FEBd1. 169 -CODE 
PLAN80.CODE AS Z2/-FES-81 . 199 CODE 
EXO1. TEXT 6 20-JAN-81 248 TEXT 
EXO1A. TEXT 4 20-JAN-81 254 TEXT 
XXO1A. TEXT 4 20-JAN-81 258 TEXT 
< UNUSED > 18 262 


11/11 FILES, 18 UNUSED, 18 IN LARGEST 


COPY PROTECTION 
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Note that the PLAN80: diskette contains the files SYSTEM.STARTUP 
and PLAN80.CODE. The latter includes most of the PLAN80 system, 
but will operate only if you have booted your system with the 
diskette containing SYSTEM.STARTUP. 


The next few pages explain how to copy PLAN80.CODE. You may make 
aS many copies as you need for backup and operational purposes. 
However, you will not be able to copy SYSTEM.STARTUP. 


You must boot with the PLAN80: distribution diskette before 
running PLAN80. After booting you should always operate from a 
diskette copy, not from the original. Once you boot with the 
distribution diskette you will probably not have to use it again 
until you next enter the Language System to run PLAN80. 


Warning: except for booting and as a source for copying files the 
- distribution PLAN80: diskette will not behave normally. 
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FORMATTING BLANK DISKETTES 
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We will now create backup copies of the PLAN80 system files. You 
should use your original PLAN80: diskette only when you boot your 
system and then operate exclusively from copies of this diskette. 


With the Apple II you may copy to any 5-inch diskette, but before 
you use one for the first time it must go through a _ process 
Called "formatting". Formatting sets up directory space and 
marks the. start of each of the diskette's 35 tracks. Formatting 
is done by a program on the diskette APPLE3:, and aé_e freshly 
formattted diskette is automatically given the name "BLANK:". 


EXECUTING THE FORMATTER 


Key "Q" to quit the Filer. |The COMMAND prompt line will appear. 
Key "X" and your computer will ask 


EXECUTE WHAT FILE ? 
Remove the PLAN80: diskette, insert the one marked APPLE3: that 
came with your language system, and enter "APPLE3:FORMATTER". 
You will see the message ; 


APPLE DISK FORMATTER PROGRAM 
FORMAT WHICH DISK (4, 5, 9..12) ? 


Remove APPLE3:, insert a BLANK: diskette and enter "4", 
If the diskette inserted is not blank you will be asked 
DESTROY DIRECTORY OF <diskette name> ? 


In this case key "N" (unless you know what you are doing) and you 
will again see 


FORMAT: WHICH DISK (4, 5, 9.e12) ? 


Insert a blank diskette this time and enter "4", The disk drive 
will whir and click, and after 30 seconds you will again see the 
"FORMAT WHICH DISK" message. Remove the freshly formatted 
diskette and repeat the process for three other blank diskettes, 
When you are done press the RETURN key without any number. You 
will see 


PUT SYSTEM DISK IN #4 AND PRESS RETURN 
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Remove the last diskette formatted, insert PLAN80: and press 
RETURN. You will see 


THAT'S ALL FOLKS... 


and the COMMAND prompt line will appear at the top of your screen, 


COPYING A FILE 


You should now have four freshly formatted diskettes, each of 
which has been named "BLANK:". You will now copy files from your 
original PLAN80: diskette to one of these BLANK: diskettes. 


Key "F" to get into the Filer, and depending on the number of 
disk drives in your system, follow the appropriate procedure 
below to copy the file SYSTEM.PASCAL. 

In the Language System files are "transfered" when they are 
copied. The transfer operation has a source and a destination. 
A source specification, "PLAN80:SYSTEM.PASCAL", for example, 
indicates that the source is the diskette PLAN80: and the file to 
be transferred is SYSTEM.PASCAL. A destination specification, 
"BLANK:$", indicates that the destination is the diskette BLANK: 


and the "$" causes the copied file to keep the same name _ on 
BLANK: as it had on PLANS80O:. 


WITH A SINGLE DRIVE SYSTEM 


Key "Tt" ae your computer will ask 
TRANSFER ? 

Enter "PLAN80:SYSTEM.PASCAL" and the computer will respond 
TO WHERE ? 

Enter "BLANK:$" and you will see 


PUT IN BLANK: 
TYPE <SPACE> TO CONTINUE 


Remove PLAN80:, insert BLANK: and press the spacebar. You will 
be told alternately to insert PLAN80: and _ BLANK: until . the 
message 


PLAN80: SYSTEM. PASCAL 
--> BLANK: SYSTEM. PASCAL 


indicates that the file has been copied. 
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WITH A MULTIPLE DRIVE SYSTEM . 


Key "fT" and you will see 
TRANSFER ? 

Enter “PLAN80:SYSTEM.PASCAL" and the response will be 
TO WHERE ? 


Insert a BLANK: diskette in drive #5 and enter "BLANK:$". Ina 
few seconds you will see 


PLAN80: SYSTEM. PASCAL 
--> BLANK: SYSTEM. PASCAL 


indicating that the file has heen copied. 


NOW COPY OTHER FILES 


You should now repeat the copying process for all other files on 
the PLAN80: distribution diskette, except for SYSTEM.APPLE and 
SYSTEM. STARTUP. (SYSTEM.APPLE is only used when you boot. And 
Since you will not boot from the copy you are making you _ can 
leave it off and have more room for PLAN80 application files.) 


Please do not even attempt to copy SYSTEM.STARTUP. If you do you 
“will produce an invalid directory entry which can only be removed 
by reformatting the diskette. When finished copying you should 
use the "E“ command to look at the directory of BLANK:. zt 
should appear as follows 


BLANK : 

SYSTEM. PASCAL 41 22-SEP-80 6 CODE 
SYSTEM.MISCINFO 1 4-MAY-79 47 DATA 
SYSTEM. EDITOR 47 24-SEP-80 48 CODE 
SYSTEM.FILER 28 18-SEP-80 95 CODE 
SYSTEM. LIBRARY 34 19-SEP-80 123 DATA 
PLAN80 .CODE 49 27-FEB-81 157 CODE 
EX01. TEXT 6 27-FEB-81 206 TEXT 
EXO1A. TEXT 4 20-JAN-81 212 TEXT 
XXO1A. TEXT 4 20-JAN-81 216 TEXT 
< UNUSED > 60 220 


9/9 FILES, 60 UNUSED, 60 IN LARGEST 
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RENAMING A DISKETTE 


Now that you have copied files from PLAN80: you should rename 
BLANK:, reserving that name for freshly formatted diskettes. 


To change BLANK: to PLAN80: make sure that the original PLAN80: 
has been removed and that the BLANK: diskette is in the boot 
drive, Key "C"' from the Filer and you will see 

CHANGE ? 
Enter "BLANK:" and the response will be 


CHANGE TO WHAT ? 


Enter "PLAN80:" and the message 


BLANK : --> PLAN80: 


will confirm that the change has occurred. You should label the 
diskette with its new name. Incidentally, always use a soft 
marking pen on diskette labels. Diskettes are very fragile, and 
pens and pencils can make small distortions that may greatly 


reduce the life of a diskette (as will dust, fingerprints, etc.). 


COPYING AN ENTIRE DISKETTE 


Previously you copied individual files from one diskette to 
another. Now you will copy an entire diskette. Depending on the 
number of disk drives in your. system, continue with the 
appropriate procedure below. You should frequently "backup" your 
important diskettes. 


WITH A SINGLE DRIVE SYSTEM 


From the Filer key "T". You will see 

TRANSFER ? 
Put a write-protect tab on your new PLAN80: diskette and insert 
it in drive #4. Enter "PLAN80:" (including the colon ":") and 
the computer will respond 


TO WHERE ? 


Enter "BLANK:", the name given each diskette by the formatter. 
You will be asked 


TRANSFER 280 BLOCKS ? (Y/N) 
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Key "Y" and you will see 


PUT IN BLANK: 
TYPE <SPACE> TO CONTINUE 


Remove PLAN80:, insert one of your BLANK: diskettes, press the 
spacebar and you will be asked 


DESTROY BLANK: ? 
Key "Y" and in a few seconds you will be told 


PUT PLAN80: IN UNIT #4 
TYPE <SPACE> TO CONTINUE 


Remove BLANK:, insert PLAN80:, press the spacebar and = 
in a few seconds you will be told 


PUT BLANK: IN UNIT #4 
TYPE <SPACE> TO CONTINUE 


Alternately insert PLAN80: and BLANK: as directed. 
~In about three minutes you will see . 


PLAN80 : =~>° BLANK: 


WITH A MULTIPLE DRIVE SYSTEM 


From the Filer key "T", You will see 

TRANSFER ? 
Put a write-protect tab on your new PLAN80: diskette and insert 
it in drive #4, Enter "PLAN80:" (including the colon ":") and 
the computer will respond 


TO WHERE ? 


Enter "BLANK:", the name given each diskette by the formatter. 
You will be asked 


TRANSFER 280 BLOCKS ? (Y/N) 


Insert one of your BLANK: diskettes in drive #5, key "Y" and you 
will be asked 


DESTROY BLANK: ? 
Key "Y" and in about 30 seconds you will see 
PLANS80: --> BLANK: 
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NOW MAKE COPIES OF DEMO 80 


Now you have two copies of PLAN80:, identical in name and 
content. Next you should make two copies of the DEMO80: 
diskette, using the same procedure used for the second copy of 


SOME ADDITIONAL FILER PROCEDURES 


The following procedures will be helpful when you develop and 
operate PLAN80 applications. They show you how to rename a file, 
delete a file and move the files on a diskette so that all unused 
space occurs in a single block -- a process called "crunching". = 


RENAMING A FILE 


Previously you changed the name of a diskette from BLANK: to 
PLAN80:. To change the name of the file EX01.TEXT on diskette 
PLAN80: to EX99.TEXT, for example, make sure PLAN80: is on-line. 
Key "C" from the Filer and you will see 
CHANGE ? | 
Enter "PLAN80:EX01.TEXT" and the response will be 
CHANGE TO WHAT? 
Enter "EX99.TEXT" and the message 
PLAN80:EX01. TEXT =~>-EX99 -TEAT 
will confirm that the change has occurred. Also you should look 


at the directory of PLAN80:. Now change the file's name back to 
EX01.TEXT and check the directory again. 


DELETING A FILE 


Whenever you want to remove a file from a diskette key "R" from 
the Filer and the computer will ask 


REMOVE ? 


With PLAN80: on-line enter "PLAN80:EX01.TEXT" and you will see 


PLAN80:EX01. TEXT | ==> REMOVED 
UPDATE DIRECTORY ? : 


Avoid the deletion by keying "N",: tf you key "YY". you would 
delete the file. : 


CRUNCHING A DISKETTE 


Whenever you delete a file the space it occupied shows as 
"UNUSED" in an extended directory listing, and whenever you add a 
file to a diskette the file is placed at the start of the largest 
unused section, These practices clutter the appearance of the 
directory listing and may leave no Single unused section large 
enough to contain a new file you-wish to add. 


The Filer is used to move all files to the front of a diskette, 
leaving one large unused block at the end. This operation is 
called "crunching". To crunch a diskette key "K" from the Filer 
and you will see 

CRUNCH ? 
Enter "PLAN80:" and the computer will ask 

FROM END OF DISK, BLOCK 280 ? (Y/N) 


Key "Y" and each file's name will be shown as it is moved 
forward. When complete you will see 


PLAN80: CRUNCHED 
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RUNNING PLAN80 FROM ONE DISKETTE 


You are ready to run a PLAN80 example. The following procedure 
is used to operate PLAN80 from one disk. It may be used by 
multiple as well as single drive systems. ; 


Boot your system with the original PLAN80: if you have not 
already done so. You should see the command line 


COMMAND: E(DIT, R(UN, F(ILE, C(OMP, L(INK, X(ECUTE ... 


Insert. a, copy of -PLAN80:. (not the ‘original). This diskette 
contains Examples 1 and 1A in addition to the PLAN80- system. 


Key "X" and the computer will ask 
EXECUTE WHAT FILE ? 
Enter "PLAN80". In a few seconds you will see the PLAN80 prompt 


PLAN80 VERSION 1.1 COPYRIGHT (C) 1981 
BUSINESS PLANNING SYSTEMS, INC. 


INPUT NAME OF PROCEDURE FILE: 
---> 


EXECUTING EXAMPLE 4 


Enter. "EX01". Example 1 will appear on your screen just as it 
was shown in Chapter 2 of the PLAN80 Language manual. Each 
statement appears as it is being processed. You may stop 
processing by holding down the CTRL key while you key "S", This 
sequence is called "CTRL-S" and operates as a switch turning 
processing on and off. Go ahead and try it a few times. You may 
use this key at any time to stop and start processing. 


After you see the DISPLAY statement you will see a menu titled 
"DISPLAY COMMANDS". Key "D" and you will see the first three 
columns of the output report. Let's investigate the control you 
have over the output. 


Key CTRL-A (press CTRL, hold it down and then key "A"). Did you 
know that the screen is twice as wide as it appears? You may use 
CTRL-A to toggle from one side of the display to the other. 


Key "C", enter "4" and key "D". Now the display begins with the 
fourth column, 
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CURSOR MOVEMENT 


Key "J" several times to see the effect of scrolling left one 
column at a time. 


Key "R", enter "10" and key "D" to start the display from row 10. 
Key "I" to scroll upwards by a half page. 


Experiment with the keys I,J,K and M. Then press the spacebar to 
return to the DISPLAY COMMANDS menu. Now experiment more with 
the I,J,K and M keys. You can observe their effects in the 
starting column and row numbers at the upper right hand corner of 
the display. Using these keys set both of these values to "1". 


DISPLAY OPTIONS 


Key "1", enter "1" and key "D". Observe that column headings are 
now shown as one line names instead of three line descriptions. 


Key "2", enter "1" and key “D". Observe that row headings are 
now shown as one line names also. 


Key "3", enter "8" and key "D". This reduces the width of the 
row description from 16 to 8 characters. Note that an additional 
column appears on the screen (CTRL-~A reveals only one column 
now). 


Key "4", enter "6" and key "D". This reduces column width from 8 
to 6 characters. Note that all columns now appear on the screen. 


Key "5", enter "30" and key "D". The screen width has' been 
reduced from 80 to 30 characters. 


Key "6", enter "9" and key mp", The screen length has’ been 
reduced from 24 to 9 lines. 


Now undo what you've done. Key "S" and "D" to see the effect of 
resetting all options to their standard values. 


Press the spacebar to return to the DISPLAY COMMANDS menu. 


INTERRUPTING THE DISPLAY 


Key "D" again and then press any key after only a few lines have 
been displayed. You should be able to interrupt the display 
and/or scroll rapidly at any point. (Some external terminals and 
80-Character boards won't give you this feature.) 
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PRINTED OUTPUT 


Key "7" and enter the maximum width of a print line. 
Key "8" and enter the maximum number of lines per page. 


Turn your printer on. Key "P" and you will be asked to input the 
destination 


INPUT DESTINATION --> 


If you have a printer enter “PRINTER:" or “REMOUT:", depending 
upon the slot in which your printer's interface card is located. 
You may also enter "CONSOLE:" or just press RETURN to print the 
output on your screen, 3 


You may press any key to interrupt printing. 


Key "X" to leave the display mode. Since no statements follow 
the DISPLAY statement, you will return to the PLAN80 prompt line. 


EXECUTING EXAMPLE 1A 


From the PLAN80 prompt line 


PLAN80 VERSION 1.1 COPYRIGHT (C) 1981 
BUSINESS PLANNING SYSTEMS, INC.: 


INPUT NAME OF PROCEDURE FILE: 
---> 


enter “EX0O1A". Example 1A is very similar to Example ] except 
that you can change any value before calculating and displaying 
the results, and you can repeat any number of times the process 
of changing values interactively, recalculating and displaying 
results. 


The first time through don't make any changes in the INTERACTIVE 
mode. Just key "X" to leave. You will soon be in the DISPLAY 
mode and the display will be the same as for Example l. Note 
that 1981 sales and net income are 100 and 18 repectively. 


Key "X" to leave the display mode. 


You are now in the INTERACTIVE mode again. You may view and 
change any data value. First, let's examine what occurs. Key 
"K™ a dozen times. Observe how the display changes. Each time 
you key "K" the display advances one column to the right. Now 
try the I, J and M keys. Note how the display wraps around in 
any direction if you get to the last row or column. 
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Key "C" and enter "1" for the first column. Key "R" and enter 
"8" for the eighth row. You should see 18 as the value for 1981 
net income. Key "R™ and enter "1". You should see 100 as the 
value for 1981 units. 


Enter "120" to change the number of units. You may also 
terminate the entry of a number with any command key. For 
example, a "J" would have entered the new value and advanced the 
display to 1982. Key "X" to leave the interactive mode. You 
will see the rules statements again and then the DISPLAY COMMANDS 
menu. 


Key "D" and note that units are now 120 and net income is 23. 


Study the display and decide on other changes to investigate, 
Key "xX" to leave the display mode and enter your changes in the 
interactive mode. 


Before leaving the example you may print your results. 


If you key "!" as an option in either the DISPLAY or INTERACTIVE 
mode you will be returned to the PLAN80 prompt line, and if you 
key "#" you will exit PLAN80 completely. These keys require that 
you simultaneously press two keys, making it less likely that you 
will accidently exit from PLAN80. 


RUNNING OTHER EXAMPLES 


You may run some of the examples from DEMO80: at this’ time. 
Appendix A discusses the output and PLAN80 statements of each 
example. If you have a one-drive system you will need to copy 
examples from DEMO80: to PLAN80: using the procedures covered in 

chapter 3. If you have a multiple-drive system then you should 
use the following procedure which permits you to run applications 
from a diskette other than the one containing the PLAN80 system. 


RUNNING PLAN80 FROM TWO DISKETTES 


Boot your system with PLAN80: in drive #4 and DEMO80 in #5. When 
the COMMAND prompt line appears, key "F" for the Filer and then 
key "P®, The screen will read : 

PREFIX TITLES BY ? 
Enter "DEMO80:" and the computer will respond 

PREFIX IS DEMO80: _ 3 


Quit the Filer. Key "X" and the computer will ask 
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EXECUTE WHAT FILE ? : 
Since the prefix value is no longer PLAN80: you must tell the 
System that the PLAN80 system is on the diskette PLANS80: Enter 
"PLAN80:PLANSO". Now you may run any of the DEMO80: “examples - 
just aS you ran EX0] and EXO1A above without providing a diskette 
name. 


If you do not change the prefix value you may run _ PLAN80 
applications from a second diskette by specifying the diskette 
name aS in DEMO80:EX01. You should note, however, that some of 
the examples on DEMO80: require you to set the prefix to DEMO80:. 
Example 7, for example, calls the file PROCO7.TEXT without 
specifying the diskette name. Thus even though Example 7 is on 
DEMO80: it would look for the file PROCO7.TEXT on diskette 
PLAN80: if the prefix were not set to DEMO80: 


LISTING PLAN80 STATEMENTS 


LL SS SS SS SS SS SS. SS GE ey GE Gy Soe SS SSS SET GS Oe Go EES Gee Gee SEP GEE Eee EES GSS Ge GU eee GOP GED Gre GS GED GES GE Gm GIS Exe GD GED GED GD Cee GED GOD GES GES Gee Ge Oe ee 


To list PLAN80 statements on a printer you will generally use the 
Filer to transfer the appropriate text file(s) to either the 
PRINTER: .oOr REMOUT: volume. You may, however, list PLAN80 
statements as they are processed by the PLAN80 system, You may 
specify the printer volume name PRINTER: or REMOUT: (but not #6: 
or #8:) when you provide the procedure file name to PLAN80. 


PLAN80 VERSION 1.1 


INPUT NAME OF PROCEDURE FILE: 
---> 


If you enter "“EX01 PRINTER:" (or "EX01 REMOUT:"), for instance, 
Example 1 will be listed on your printer instead of your screen, 


INTERRUPTING PLAN80 IN GENERAL 


Sometimes in operating PLAN80 you will want to interrupt 
processing immediately instead of waiting for the end of output 
or calculations. For instance, you might start a cash flow 
application, but remember that you forgot to change a sales 
assumption. Or half-way though printing a page you might wish 
you had begun with a different column or row. 


At any time you may key an exclamation mark "!" to escape from 
the current file or a pound sign "#" to leave PLAN80. "i" lets 
you leave the current application to run another, and "#" lets 
you leave to go into the Editor or leave PLAN80 entirely. (As in 
the DISPLAY mode this feature may not work with some external 
terminals or 80-column boards.) 
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INTRODUCING THE EDITOR 


To change PLAN80 statements you will use another Language System 
facility called the Editor. 


The Editor helps you create and modify text files. It has 
commands which permit you to move the cursor to any position 
within a text file, and add, delete or change text at the cursor. 
position, 


The Editor is also discussed in Appendix C of this manual and in 
Chapter 4 of the "APPLE PASCAL Operating System Reference Manual. 


This chapter will introduce you to the most important edit 
commands. First we'll use two other features of the Filer, 
however. Make sure that PLAN80: is in drive #4, 


SETTING THE DATE 


You should make sure that the date has been set correctly before 
modifying any of your files. You may name a file "T3Q" and know 
exactly what it means today. But two months from now only the 
date may indicate whether file "T3Q" or "T36" is the more recent. 
From the Filer key "D" and you will see 


DATE SET: <1..31>-<JAN..DEC>-<00..99> 
TODAY IS dd-mmm-yy 
NEW DATE ? 


Enter a date in one of the following formats: 


31-JUL-81 
1-AUG 
2 


The most recent date appears on the welcome message when you 
boot, and the directory of each diskette shows the date 
prevailing when the file was created or most recently modified. 


GETTING A FILE 


If you have a two drive system use the "V" and "P" keys to make 
sure that the prefix value is "PLAN80". 


We will use the Filer to "get" a file before editing and _ to 
"save" the file after editing. This procedure will help you save 
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files automatically under the right name and prevent you from 
destroying other files accidently. 


From the Filer key ne gs 5 OU will see 
GET 2 | 

Enter "EXO1" and the system will inform you 
TEXT FILE LOADED 


Key —"Q" to quit the Filer. Key "E" for the Editor. In a few 
seconds you will see the input statements for Example l. 


GETTING A FRESH COPY 


You should experiment at length with the cursor moving and text 
changing commands. Every so often you may want to discard your 
practice file and get a fresh copy before experimenting further. 
The following procedure will let you do this. Try it now so that 
you see how it works. | 


Make sure the EDIT prompt line appears. Key "Oo" and you will see 
a QUIT menu. Key "E" and you will exit from the Editor without 


saving your file. Key "E" again to reenter the Editor and you 
will see a fresh copy of the file you were editing. 


THE EDITOR 


CURSOR MOVING COMMANDS 


Let's examine the important cursor moving commands. 

Key "JE" and you jump to the end of the file. 

Key "JB" and you jump to the beginning. 

Key "P" and you advance a page. Key "JB" again. 

Press the spacebar a few times and watch the cursor. After 
you've gone to the second line, backup with the left arrow key. 
Note how the cursor avoids blanks before the first character and 
rests on a blank at the end of the line. Later we'll discuss 
that blank. 

Press the RETURN key a few times. Note how the cursor moves to 
the start of the next line. 
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REPEAT FACTORS 


Key "8" and press the space bar. Note how the cursor advances as 
though the spacebar had been pressed eight times, 


Key "3" and press the RETURN key to move three lines, 


Key "20" and press the left arrow key to move left (and up) by 20 
characters. 


Key "20" and press the right arrow key to move right (and down). 


THE SET DIRECTION 


Note the ">" sign at the left end of the EDIT prompt line. Watch 
it as you alternately press the key containing the "<" and its 
neighbor ">", either shifted or unshifted. Now leave the display 
with a "<" and press the spacebar and RETURN keys a few times. 
Also try the "P" key. Try using repeat factors. Now you can move 
the cursor in terms of characters, lines or pages in either 
direction, and you can jump to the beginning or the end. 


PRACTICE MAKES IT EASY 


Practice with the above keys for a few minutes. Use a 
combination of set direction, repeat factors and the movement 
keys to move the cursor to any character in the file. | 


When you feel comfortable with the movement commands Le create 
a new example, using the text changing commands . 


TEXT CHANGING COMMANDS 


Positon the cursor at the begining of the file. We want to 
change "#1" in the second line ‘to "#1B". Check the _ set 
direction. It should read ">". Key "30" and press the spacebar. 
Oops, too far! Backup with the left arrow key twice. This is 
where we want to insert a "B". 
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INSERT 


Key "I" to go from the EDIT to the INSERT prompt line. Note 
that the quote mark disappeared. Use CTRL-A to see it at the far 
right of the second line. Use another CTRL-A to return to. the 
left side. Type "C" (don't press RETURN). But we wanted a "B" 
nota "Cc"! No problem, use the left arrow key to eliminate any 
mistakes. Type "B" this time and then CTRL-C to accept the 
insertion. Note that the quote mark has returned. 


Let's add" - ANALYSIS OF PROFITS" after the "B" just inserted. 
Key "I" and type a few characters of the new insertion. Oops! 
We really don't need this ineertion at alt. Press ESC and 
whatever you typed will be rejected. * 


DELETE 


Press the spacebar enough times to put the cursor on the "F" of 
"PIVE YEAR" and key "D". The DELETE prompt line appears. Press 
the spacebar 10 times. Blanks appear where text has _ been 
deleted. Hit the left arrow key five times. See how the deleted 
text reappears. Press ESC and everything is restored, 


Key "D" again, key "10" and press the space bar once. All 10 


characters are blank. This time press CTRL-C. The deletion has 
been accepted. 


CHANGE 

Key "14" and press the spacebar. The cursor should be on_ the 
beginning of the word "MODEL". 

Key "X". The EXCHANGE prompt line appears. Type "STUDY". Press 
the left arrow key three times. The original text is restored. 


Press ESC and the word "MODEL" has been restored. 


Key "X" again, type "STUDY" and press CTRL-C; The EDIT prompt 
line appears, and the word "STUDY" remains. 


ESCAPE AND CONTROL-C 


Note that for all three modes, insert, delete and change, changes 
were rejected when we used ESC and accepted when we used CTRL-C. 
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DELETING A BLOCK OF TEXT } 


Press RETURN twice. The cursor should be on the Y1981 line. Key 
"D", press RETURN five times and press CTRL-C. All the column 
statements are gone. 


THE COPY BUFFER 


What if deleting that sizeable block of text had been a mistake? 
You can recover. Key "CB" (for copy buffer) and presto the 
deleted text reappears. Every time you insert or delete, the 
copy buffer maintains a copy of the inserted or deleted text. 


Let's do it again. Key "D", press RETURN five times and press 
CTRL-C. Now key "I" to start an insertion and press ESC. We are 
pretending that you made a deletion error and started an 
insertion. Key "CB". Nothing this time! Entering the insert or 
delete mode clears the copy buffer. Fortunately, it's OK that we 
destroyed those column headings because we want new ones anyway. 


CREATIVE DELETION 


The cursor should be on the first character of ":ROWS". Key "I", 
type two blanks and then the following (including quote marks) : 


CASE1 "CASE 1" "WORST" “"CASE" 


Press RETURN. Note that we are inserting a RETURN just as_ we 
inserted other characters. Now press CTRL-C. We will use this 
first line as a model for two additional lines 


CASE2 "CASE 2" "MOST" "LIKELY" 
CASE3 "CASE 3" "BEST" "CASE" 


Move the cursor to the start of the CASE] line, key "D" and press 
RETURN and CTRL-C. Now key "CB" three times. You should have 
the original plus two lines that can be edited faster than they 
could be typed. 


Move the cursor down one line and change the "1"'s to "2"'s, 
Then change the remaining words by a process of deletion and 
insertion. Do the same for the CASE3 line. 


If you are a little uncomfortable making these changes then you 
should review the material above and practice similar changes. 
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DELETING TO THE END OF A LINE 


Key "P" to advance the display a page, place the cursor on the 
start of the number 118 on the UNITS data statement, key "D" and 
press return. Now type CTRL-C and see what happens to the PRICE 
line, which follows the UNITS line. It is now part of the UNITS 
line. How did this happen? : 


Recall that on each line the cursor will move one space to . the 
right of the line's last character. That blank on the end really 
isn't a blank. It's the character generated when you insert a 
RETURN. . 


With your cursor on the "P" of "PRICE" enter the insert mode, 
press RETURN and type CTRL-C. Price should be on its own line 
again because of the RETURN that you inserted. Use the left 
arrow key to back up the cursor to the UNITS line and insert 
"(+20)". Remember to accept the insertion with a CTRL-C. 


Move the cursor to the "3" of "1.32", key ny 7. type 150 +” ane 
accept. Now you want to delete the rest of the line but avoid 
having to insert a RETURN as we did above. 

Key "D" and press RETURN. Press the left arrow key to back up to 
the previous line, they type CTRL-C. That's how to delete the 
end of a line. Rs 


Change the OVERHEAD line the same way. 


MAKING EXAMPLE 4B INTERACTIVE 


The text from :RULES through :DISPLAY resides in the file 
XXO1A.TEXT which is used for Example lA. We can use that’ same 
file to make Example 1B interactive. 


Place the cursor at the start of the line :RULES, ‘key “p", key 
"99", press RETURN and type CTRL-C. You have deleted to the end 
of the file. Insert the following line at the end of the file 


:REPEAT "XX0O1A.TEXT" 
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SAVING THE NEW EXAMPLE 


STEP 4 - SAVING THE WORKFILE 


To save your new example make sure that the EDIT prompt line 
appears and — 


*~ key "0" to quit the Editor, 
= key “U* to update the workfile, 


You should see the COMMAND prompt line and your workfile has been 
saved as SYSTEM.WRK. TEXT. 


TESTING 


Before saving your new file with a new name you should test it 
and make any corrections or other changes. To operate PLAN80 key 
"X" from the COMMAND prompt line. You will be asked : 


EXECUTE WHAT FILE ? 


Enter "PLAN80" and the computer will respond 
INPUT NAME OF PROCEDURE FILE: 
---> 


Press the RETURN key. This tells PLAN80 that you want the file 
"SYSTEM.WRK.TEXT". Operate the example just as you operated 
Example 1A earlier. When done key "E" from the DISPLAY COMMANDS 
menu and you will see the COMMAND prompt line. You may further — 
edit and operate your new example. For example, you might add 
rows for “SELLING EXPENSE" and “OTHER INCOME", including 
appropriate data and rules statements. Make sure you obtain the 
right results. 


STEP 2 - SAVING PERMANENTLY 


Step 1 above saved your workfile as "SYSTEM.WRK.TEXT". This step 
will save "SYSTEM.WRK.TEXT" as “EX01B. TEXT". 
* Key "F" for the Filer, and 
* key "S" and you will see 
SAVE AS PLAN80:EX01 ? 
Key "N" because you want a new name, not EX01. ‘You will be asked 
SAVE AS ? 
Enter "EX01B"., After the workfile is saved you will see 
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TEXT FILE SAVED 


Note that with a second disk drive you could save the workfile on 
DEMO80:. In this case the computer proceeds more cautiously and 
asks you if you want to remove any old file which has the same 
name as the one you are saving. Also it provides more complete 
messages showing you the full name, including diskette name, of 
the workfile and of the new file. 


Key "Q" to leave the Filer. 


STARTING FROM SCRATCH 


The following will show you how to clear the workfile and begin 
editing an empty file. you should keep in mind that’ the 
structure of most PLAN80 applications is similar. Hence, it is 
often preferable to begin with an old application even if you end 
up changing almost every line. 
To start editing with an empty screen begin with the COMMAND 
prompt line and key "F" for the Filer and "N" (for new) and if 
there is a workfile you will be asked 
THROW AWAY CURRENT WORKFILE ? 
Key "Y" and in any event you will receive the message 
WORKFILE CLEARED 
Key "Q" to quit the Filer and "E" for the Editor. You will see 
NO WORKFILE IS PRESENT. FILE ? 


Press RETURN and the EDIT prompt line will appear. Key "I" (for 
insert) and begin entering your PLAN80 statements. 
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EXAMPLE 1A 


— oe ee Oe et SP oe ee Se Gar ene Gee Ge See me Se cee Gee Gm EES Gee GES Ee ORE Gm Gee Ge eee Gm Gee Grek Gee Gee Ge Gee ee eee eee ee Gm Gee Oe ee ee ome es eee Geo Gee Gee Gee Ge ee Gee Gee GES GEE Ge Ge Ge Gee GE GN os om 


Example 1A is similar to Example 1 which appéars in the PLAN80 
Reference Manual. Example 1A produces the same report, however, 
it uses two additional PLAN80 features, | | 


First, the REPEAT statement lets you repeatedly execute a_ block 


of statements, and second, the INTERACTIVE statement allows you 
to change data interactively. 


In the original Example 1 all statements are in one text file and 
each statement is executed once, In Example 1A the statements 
are in two files. At the end of the first is a REPEAT statement, 
which calls in the second file. Each time the latter is called, 
you may change any values, and then’ recalculate and display or 
print results. 


PLAN80 EXAMPLE #1A - INTERACTIVE 
FIVE YEAR PROFITABILITY MODEL 


1981 1982 1983 1984 1985 


ASSUMPTIONS 
UNITS 100 118 142 170 204 
PRICE Ae oe 1.49 1.64 1.80 1.98 
UNTT COST 0.818 0.919 1.029 1.153 L.29l 
TAX RATE 0.460 0.460 0.460 0.460 0.460 
DOLLARS (THOUSANDS) 
SALES 132 176 Z2a2 306 404 
COST OF SALES 82 108 146 196 263 
OVERHEAD : Ly 19 21 22 24 
PROFIT BEFORE TAX 33 48 66 88 ii? 
TAXES 15 22 30 41 54 
NET INCOME 18 26 36 48 63 
MARGINS (PERCENT) 
GROSS PROFIT 38.0 38.3 37.2 36.1 34.9 
OPERATING PROFIT 2052 27.5 28.4 28.8 29.0 
NET INCOME 1336 14.9 15.3 15.6 15.6 
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* * * PILE: "EXO1A.TEXT™ * * * 


: TITLES 

1 "PLAN80 EXAMPLE #1° 

2 "FIVE YEAR PROFITABILITY MODEL" 
: COLUMNS | . 

y1981 "1981" 

YI982 1982" 

y1983 "1983" 

¥1984 "1984" 

¥1985 "1985" 


: ROWS | 
UNITS "ASSUMPTIONS" 
* UNITS" 
PRICE (2) * PRICE" 
ucost (3) “ UNIT COST" 
TAXRT (3) " TAX RATE" 
SALES "DOLLARS (THOUSANDS) * 
" SALES" 
cost " COST OF SALES" 
OVERHEAD " OVERHEAD" 
PBT (-) " PROFIT BEFORE TAX" 
TAXES " TAXES" ; 
NET (-=) " NET INCOME” 
GPM (1) “MARGINS (PERCENT) ® 
" GROSS PROFIT" 
OPM (1) " OPERATING PROFIT" 
NPM (1) " NET INCOME" 
:DATA : 
UNITS = 100 118 (*1.20) 
PRICE = 1.32 1.49 (*1.10) 
UCOST = .818 .919 (*1.12) 
TAXRT = .46 + 
OVERHEAD = 19 19 (*1.08) 


:REPEAT “XXO1A.TEXT" <- - - 


ee ——— 


ee PILE: “EXOLA. TEXT? .-* * * 


| 

| 

| : INTERACTIVE i 
| :RULES I 
1 SALES = UNITS * PRICE i 
i cost = UNITS * UCOST I 
i PBT = SALES - COST - OVERHEAD I 
| TAXES = TAXRT * PBT i 
| NET = PBT - TAXES | 
| GPM = 100 * (SALES - COST) / SALES |! 
| OPM = 100 * PBT / SALES ' 
i NPM = 100 * NET / SALES I 
: i 
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EXAMPLE 2 


2 Le a Se Say eS Se So Se Ce GS GRY GES GaP GeO CONS GS GET Gee Ge Ew GE Gr aE Ge SS ED GSS Go GED OD GED GE Ge GED GE Gm GE> GET Ge Gm GEE Ge Gee OS GEE OES Ger GS USD GE GS GD Ge GD any Gus oR? GE OS a ame a a 


You should observe how district and product names have _ been 
developed, Logical structure is important. You can duplicate 
blocks of row statements and rules, making only a few changes 
instead of typing all characters. Future changes will be easier 
and you will be more accurate. 
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DISTRICT 
PRODUCT 
PRODUCT 
PRODUCT 


WN bh Dy 


TOTAL 


- DISTRICT 
PRODUCT 
PRODUCT 
PRODUCT 


WN eo 


TOTAL 


DISTRICT 
PRODUCT 
PRODUCT 
PRODUCT 


WNE A 


TOTAL 


TOTAL COUNTRY 
PRODUCT 1 
PRODUCT 2 
PRODUCT 3 


TOTAL 


PLAN8O EXAMPLE #2 
SALES ANALYSIS BY QUARTER 


1st 2ND 3RD 
OTR QTR OTR 
125 115 130 
100 110 115 
200 220 210 
425 445 455 
100 105 108 

90 103 100 
165 173 168 
355 381 376 
300 280 270 
195 180 185 
212 241 226 
707 701 681 
525 500 508 
385 393 400 
577 634 604 


ere eaey: ome ene cee wae men ence cme eu ee ome ee oe ae 
ae Gee ene ae eee eon A>. Same coe a as cae Se Se oe 


PERCENT BY PRODUCT 


PRODUCT 1 
PRODUCT 2 
PRODUCT 3 


TOTAL 


PERCENT BY DISTRICT 


DISTRICT A 
DISTRICT B 
DISTRICT C 


TOTAL 


100.0 100.0 100.8 
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* *-* FILE: 


: TITLES 


"EXO2.TEXT" * * & 


1 “PLAN80 EXAMPLE #2" 
2 "SALES ANALYSIS BY QUARTER" 


: COLUMNS 
Ql 

“02 
Q3 
Q4 
YEAR 

: ROWS © 
ROWAL 


ROWA2 
ROWA3 
ROWAT 
ROWB1 


ROWB2 
ROWB3 
ROWBT 
ROWC] © 


ROWC2 
ROWC3 
ROWCT 
ROWTI 


ROWT2 
ROWTS3 
ROWTT 
ROWX1 


- ROWX2 
ROWX3 
ROWXT 
ROWYA 


ROWYB 
ROWYC 
ROWYT 


gal oY eg 
w 2ND oe 
LU 3RD we 
we 4TH i 
"FULL" 


(P) 


ue QTR we 
iy QTR tt 
Ww QTR oe 
"OTR" 
oF YEAR oe 


"DISTRICT A" 
"PRODUCT 1" 
" PRODUCT 2" 
* PRODUCT 3* 
“ TOTAL" 

"DISTRICT B" 
- PRODUCT 1" 


" PRODUCT 2" 


* PRODUCT 3" 


—" TOTAL" 


"DISTRICT C" 


<2 PRODUCT 1° 


~ .BRODUCT..2" 

“- PRODUC? 3” 

">. OPAL" 
“TOTAL COUNTRY" 
= PRODUCT 1" 

~ PRODUCT 2" 


“ PRODUCT 3" 


"TOTAL" 

"PERCENT BY PRODUCT" 
> «PRODUCT .4." 

“ PRODUCT 2" 

" PRODUCT 3" 

" TOTAL" 

"PERCENT BY DISTRICT" 
“DISTRICT A" 

— DESTRIC® -B" 

" -DISTRICE :C" 

"- TOTAL" 


= £92 


— 


:DATA 
ROWAL 
ROWA2 
ROWA3 
ROWB1 
ROWB2 
ROWB3 
ROWC1 
ROWC2 
ROWC3 

: RULES 
ROWAT 
ROWBT 
ROWCT 
ROWT1 
ROWT2 
ROWT3 
ROWTT 
YEAR 
ROWX1 
ROWX2 
ROWXT 
ROWX3 
ROWYA 
ROWYB 
ROWYT 
ROWYC 

: DISPLAY 


125 115 130 120 
100 110 115 108 
200 220 210 215 
100 105 108 112 

90 103 100 105 
165 173 168 179 
300 280 270 280 
195 180 185 173 
212 241 226 219 


@SUM(ROWA1.. ROWA3) 
@SUM(ROWB1.. ROWB3) 
@SUM(ROWC1..ROWC3) 
ROWAlL + ROWB1 + ROWC1 
ROWA2 + ROWB2 + ROWC2 
ROWA3 + ROWB3. + ROWC3 


@SUM(ROWT1..ROWT3) 


@SUM(Q1..04) 
ROWT1/ROWTT*100 
ROWT2/ROWTT*100 

100 . 
ROWXT - @SUM(ROWX1. .ROWX2) 
ROWAT/ ROWTT*100 
ROWBT/ROWTT*100 

100 

ROWYT - @SUM(ROWYA. .ROWYB) 
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EXAMPLE 3 


Example 3 introduces comments into the RULES section. Also the 
OPTIONS feature is used to provide a nonstandard value for row 
description width. Lastly you should note how column headings 
have been structured, 
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ACT 
1979 
TOTAL MARKET UNITS (MILLIONS) 
PRODUCT 1] | 110 
PRODUCT 2 88 
PRODUCT 3 28 
TOTAL 226 
ABC SHARE (PERCENT) 
PRODUCT 1 30.0 
PRODUCT 15.0 
PRODUCT 3. 20.0 
TOTAL 22.9 
ABC UNITS (MILLIONS) 
PRODUCT 1 33 
PRODUCT 2 
PRODUCT 3 6 
TOTAL 
AVERAGE UNIT PRICE 
PRODUCT 1 | 0.885 
PRODUCT 2 | 0.510 
PRODUCT 3 ¥.300 
AVERAGE 0.834 
SALES DOLLARS (MILLIONS) 
PRODUCT 1 29.2 
PRODUCT 2 6.7 
PRODUCT 3 2és 
TOTAL 43.2 
AVERAGE UNIT COST 
PRODUCT 1 0.502 
PRODUCT 2 0.317 
PRODUCT 3 0.704 
AVERAGE 0.477 
AVERAGE GROSS MARGIN (PERCENT) | 
PRODUCT 1 43.3 
PRODUCT 2 37.8 
PRODUCT 3 45.8 
AVERAGE 42.9 


PLAN80 EXAMPLE #3 
PROJECTED SALES AND GROSS MARGIN 
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EST 
1980 


om ee eee ee oe oe oe 


1981 


ce emer ewe ee ee - 


* * * PILE: "EXO3.TEXT" * * * 


: TITLES 

1 “PLAN80 EXAMPLE #3" 

2 “PROJECTED SALES AND GROSS MARGIN" 
: COLUMNS 


F1979 % ACT" "1979" 

F1980 2 EST" "1980" 

F198] " “ere SOR) 

F1982 anes PROJ" "1982" 

F1983 sat meta sitic 3° "1983" 

:ROWS © 

Tl "TOTAL MARKET UNITS (MILLIONS).” 
" PRODUCT 1" 

T2 " PRODUCT 2" 

= . “ PRODUCT 3" 

T99 {~} “ TOTAL" 

Sl (SL) "ABC SHARE (PERCENT) " 
“PRODUCT 1" 

S2 (1) “PRODUCT 2" 

S3 (1) “PRODUCT 3" 

S99 (1-) "" TOTAL" 

Ul (S1) "ABC UNITS (MILLIONS) " 
" PRODUCT 1" 

U2 (1) “ PRODUCT 2" 

U3 (1) " PRODUCT 3" 

u99 f1-) "TOTAL" 

Pl (S3) “AVERAGE UNIT PRICE" 
“ PRODUCT 1" 

P2 (3) * BRODUCT 2° 

Ps (3) " PRODUCT 3" 

P95 (3-) "AVERAGE" 

D1 (S1) "SALES DOLLARS (MILLIONS) " 
"PRODUCT 1" 

D2 (1) "PRODUCT 2" 

D3 (1) " PRODUCT 3" 

D99 (i=) " TOTAL" 

ci (S3) "AVERAGE UNIT COST" 
“ PRODUCT 1" 

C2 (3) "PRODUCT 2" 

C3 (3) " PRODUCT 3" 

C99 (3-) " TOTAL" 

M1 (S1) "AVERATE GROSS MARGIN (PERCENT) " 
" PRODUCT 1" 

M2 (1) "PRODUCT 2" 

M3 (1) " PRODUCT 3" 

M99 a=} "AVERAGE" 
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TL.=-110.115..€*1.,04) 
T2 88.102 (*1.15) 
es 28. a1 - (41.25) 
Sl e230. .38 £325.335 ..35 
S2 el5n018. (+.0035) 


S3am- 520. .20: 19 (548-417 


Pl #885 99032471510) 

B2 6510+.550. (*1.08) 

P3 £530:-1245 (*1.42) 

Cl O02; «558. <i. 09) 

C2 Ji? «30: 070.92) 

C3 ~704 .664 (*1.05) 
RULES 


: TOTAL UNITS 
T99 = @SUM(T1..T3) 
: ABC UNITS = TOTAL UNITS * SHARE 


Ul = fT * Si 
U2- = TZ * 32 
Us = 93. * 83 


U99 = @SUM(U1..U3) 
TOTAL UNIT SHARE 


S99 = U99 / T99 * 100 

Sl = 51 * 100 

S2 . =. 52." £00 

SS. ..=..54..* 100 

: SALES DOLLARS = UNITS * PRICE 
Dio = UL. PL 

Dee =2U2<* 22 

D3 = U3 -* F3 

D99 = @SUM(D1..D3) 


: AVERAGE PRICE = DOLLARS / UNITS 
P99 = D99 / U99 
: COST = UNITS * UNIT COST 


Mi = UL. * Cl 
M2 n= U2 * C2 
M3. = U3 *.C3 
M99 = @SUM(M1..M3) 


: AVERAGE COST = COST / UNITS 
c99 = M99 / U99 
: GROSS MARGIN = MARGINAL REVENUE / SALES 


Ml = D1-Ml / D1 * 100 
M2 = D2-M2 / D2 * 100 
M3 = D3-M3 / D3 * 100 
M99 = D99-M99 / D99 * 100 
sOPTIONS 
ROWWID (30) 
: DISPLAY 
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EXAMPLE 4 


Example 4 shows how a cash flow statement may be derived from an 
income statment and a balance’ sheet. You should note the 
introduction of the decimal point specification in the column 
Statements. Also observe how important underlining, Spacing, 
pagination and indentation are to the effective presentation of 
results, particularly if the report is to be presented to someone 
less familiar than yourself with the numbers and structure of 
your problem. : ; 


The rules of this example introduce the @CUM function, the shift 
feature and the FOR statement. The latter prevents calculations 
from affecting the 1978 column of the cash flow page. This is 
done since cash flow values are generally constructed as the 
difference between values for consecutive years, and there are no 
prior year values for the 1978 column, 


The general logic of the cash flow rules is: 

Calculate the income statement values (RO2-RO08). 
Calculate the details of current assets (R22-R26A). 
Calculate details of liability accounts (R31-R34). 
Calculate total liabilities (R35). 

Set total assets (R27) to total liabilities. 
Calculate current assets (R24). 

Calculate cash (R21). 

Calculate cash flow values (R51-R6l1). 

Calculate actual cash change (RX3) to compare with the 
computed cash change (R61). 


WOOBNHAUSPWNHH 
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Additional Explanations 


& 


ls calculations reflect the following conventions: 

all values are input as positive numbers, 

* income items on the income statement are positive and 
expense items are negative, 

* asset values are positive on the asset side of 
the balance sheet and liability values on the liability 
Side are also positive, 

* sources of cash on the cash flow statement are positive 
and outflows negative. 


Working capital values are calculated as a function. of 
sales. Accounts receivable are 48 days worth of sales. 
Inventories use the number 60, but since standard cost is 
42% of sales the. 60 is equivalent to 60/.42 = 143 days worth 
of sales. 


Accumulated depreciation (R26A) is calculated by adding the 
1978 opening balance (R26A) and annual amounts for all years 
(R52) and accumulating the results. 


Accrued taxes (R32) are calculated as the accumulation of 
the opening 1978 balance (R32) plus the tax provision 
(RO7) less tax payments (R58). 


Changes in asset accounts such as receivables, inventories, 
investments and fixed assets are calculated as prior year 
less current year values, If an asset increases then the 
difference will be negative which is consistent with the 
convention that cash uSages are negative. 


Changes in liability accounts such as accounts payable and 
long term debt are calculated as current year less. prior 
year values. If a liability increases then the difference 
will be positive, or a source of cash. 


The last three rules provide values for the last three rows 


which show the opening and closing cash position and the net 
change for each year. 
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PLAN80 EXAMPLE #4 
PROJECTED FINANCIAL STATEMENTS AND CASH FLOW 
(THOUSANDS OF DOLLARS) 


F1979 F1980 F1981 F1982 
ACTUAL PLAN PLAN PLAN 


CASH FLOW STATEMENT 


2 Se See ee ee ee eee ee eee ee ee es eee ee eee oe eee ee 
— See ame ome Ore ae ae Ge Gee Gee See Gee aoe ame ans cue ae Ge Sune 


NET INCOME 298.0 312.2 336.0 360.0 
DEPRECIATION 70.0 90.0 120.0 140.0 
CHANGE IN WORKING CAPITAL 

ACCOUNTS RECEIVABLE “10,5 —7.9 -13.3 “133 

ACCOUNTS PAYABLE 8.8 6.6 La ou 11.1 

TOTAL -14.9 wide ~18.9 -18.9 

INCREASE DUE TO 

FIXED ASSETS =130.0 =90.0 7130.0 -30.0 

INVESTMENTS mo 20.0 wt ~20.40 
TAXES 

ADD PROVISION 220,59 2: 14339 166.0 188.0 

LESS PAYMENTS -100.0 -100.0 -100.0 -100.0 
CHANGE IN : 

LONG TERM DEBT 50.0 50.0 = 50.0 

NET CHANGE 303.9 274.9 34341 569.1 


od td me gee aie come ane const o> cmee come eee 
Se com aoe exe om — rd =~ ow am cas om 


CASH BALANCE 


CLOSING 5oo.7 830.6 1203.7 1772.8 
OPENING 251.8 555.7 830.6 1203.7 
NET CHANGE © 303.9 274.9 373.1 569.1 


ne axe ame aoe aoe a ome aoe ame ame ome oor ae ome ae oe 
om ens ao Gow Gee Ss = ome ams ome eae mS Gem EES me ae 
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PLANSO EXAMPLE #4 
PROJECTED FINANCIAL STATEMENTS AND CASH 


(THOUSANDS OF DOLLARS) 


INCOME STATEMENT 


Se 22 Se we ce ee ee eee es em one 
—t—4 event gues 


SALES 
STANDARD COST 


GROSS MARGIN 


ADVERTISING 
ADMINISTRATION 


OPERATING PROFIT 
TAX PROVISION 


NET INCOME 


BALANCE SHEET ~ ASSETS 


CASH 
ACCOUNTS RECEIVABLE 
INVENTORIES 


CURRENT ASSETS 
INVESTMENTS 
FIXED ASSETS 

GROSS 

ACCUM DEPRECIATION 


TOTAL ASSETS 


ACCOUNTS PAYABLE 
ACCRUED TAXES 
LONG TERM DEBT 
EQUITY 


TOTAL LIABILITIES 


F1978 
ACTUAL 


720.0 
-200.0 


ee cua. eu EI: EEE 


1470.4 


P1979 
ACTUAL 


1041.0 
—-437 « 2 


P1980 
PLAN 


350.0 


cen ame eer Ge” Se 


PLOW 


P1981 
PLAN 


anes em eran one. Se 
amo: Gen eM GRE: Gam 


expen, vance min: wae ere 


350.0 


ome her eR RS: CEO 


F1982 
PLAN 


Saree eon: come: muse eee 
Oma Sm: Same: GaN: 


Same eT” COR? RED. 


cove eee eee comme: eames: 
eee Gee See Cae 


* *& * 


FILE: 


: TITLES 
1 "“PLAN80 EXAMPLE #4" 
2 "PROJECTED FINANCIAL STATEMENTS AND CASH 
3 "(THOUSANDS OF DOLLARS) " 

: COLUMNS 


F1978 
F1979 
F1980 
F1981 
F1982 


> ROWS 


RO] 


(1) 
(1) 
(1) 
(1) 
(1) 


RO2 
RO3 
R04 
RO5 
R06 


(=) 


Pe) 
(P) 


"“EX04,. TEXT" .* * * 


F1978" "ACTUAL" 
F1979" "ACTUAL" 
F1980" " PLAN" 
F1981" " PLAN" 
F1982" " PLAN" 


INCOME STATMENT™ 


SALES" 
STANDARD COST" 
GROSS MARGIN" 
ADVERTISING" 
ADMINISTRATION" 
OPERATING PROFIT" 
TAX PROVISION" 
NET INCOME" 


BALANCE SHEET - ASSETS" 


CASH" 
ACCOUNTS RECEIVABLE" 
INVENTORIES" 
CURRENT ASSETS" 
INVESTMENTS" 
FIXED ASSETS" 
GROSS" 
ACCUM DEPRECIATION" 
TOTAL ASSETS" 


BALANCE SHEET - LIABILITIES" 


ee ees ee ee ee ee ce ee ee ee ee ee ee eee ee ee eee ee ee ee ee ee ee ee oe 
Sa Se ee Se ee Se ee eee ee coe me ee ane ee a SD EES GRD GRD GED Gan Soe cae Gee ae a 


ACCOUNTS PAYABLE" 
ACCRUED TAXES" 
LONG TERM DEBT" 
EQUITY" 

TOTAL LIABILITIES" 


CASH FLOW STATEMENT" 


ee ee ee 
— ee oe oe ae ee Se See ee a ae ee ee eS ee Se Se ae 


NET INCOME" 

DEPRECIATION" 

CHANGE IN WORKING CAPITAL" 
ACCOUNTS RECEIVABLE" 
INVENTORIES" 
ACCOUNTS PAYABLE" 

TOTAL" 

CHANGE DUE TO" 

FIXED ASSETS" 
INVESTMENTS" 

TAXES" 

ADD PROVISION" 
LESS PAYMENTS” 
CHANGE IN" 
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FLOW" 


LONG TERM DEBT" 


1300 
550 
1100 


400 


140 
100 


R61 (-=) * NET CHANGE" 
RX1 (SS) CASH BALANCE" 
. CLOSING" 

RX2 . OPENING" 

RX3 (-=) * NET CHANGE" 
:DATA 

ROl = 962 1041 1100 1200 

R25 = 410 410 530 530 

R26 = 720 850 940 1070 

R26A = 200 

R32 = 300 

R33 = 250 300 350 350 

R34 = 421. 

R52 = 0 70 90 120 

R58 = 0 100 100 100 
: RULES 

RO2 = -.42 * ROL 

RO3 = #£«.RO1 + RO2 

RO4 = -.08 * ROL 

RO5 = #£-50 -— (.04 * RO1) 

R06 = RO3 + RO4 + ROS 

RO7 = 75 — (.48 * ROG) 

ROS = RO6 + RO? | 

R22 = #£=RO1 * (48/360) - 

R23 = #£=RO1 * (60/360) 

R26A = -R26A — R52 

R26A = @CUM(R26A) 

R31 = ROL * (40/360) 

R32 = #£R32 — RO7 — R58 

R32 = @CUM(R32) 

R34 = #R34 + ROB 

R34 = @CUM(R34) 

R35 = @SUM(R31..R34) 

R27 = R35 

R24 = R27 - R26 - R26A —- R25 

R21 = R24 — R23 - R22 
:FOR COLUMNS=(F1979..F1982) 
:RULES 

R51 = k08 

R53 = R22(-1) - R22 

R54 = R23(-1) -— R23 

R55 = R31 —- R31(-1) 

R56 = @SUM(R53..R55) 

R56A = R26(-1) -— R26 

R56B = R25(-1) -— R25 

R57 = -RO7 

R58 = -R58 

R59 = R33 —- R33(-1) 

R61 = R51 + R52 + @SUM(R56..R59) 

RX1 = R21 

RX2 = R21(-1) 

RX3 = RX1 - RX2 
: DISPLAY | 
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EXAMPLE 5 


aS See a Se GS Ge See Gee eee ee Gee eee ee ee eS ae ee Ge ee Ee Ge Ee ee ee Gee Ee SS Ee Oe oe OE SS ee GSS Ge Ce ee Se Gee Sr Se ee ee es ee ee ee ee ee Gee ee ee ee ee ow ae oe EE ow ae 


Example 5 is an interactive application which allows you to input 
investment by period in one column and income by period = in 
another. A third column shows the discounted value of the 
investment and income amounts by period. Subtotals show the 
total of the investment and income values and confirm that the 
sum of the discounted amounts is zero, The discount factor used 
to achieve this zero total is called the internal rate of return. 


PLAN80 EXAMPLE #5 - INTERACTIVE 
INTERNAL RATE OF RETURN MODEL 
(DISCOUNTED CASH FLOW) 


INVEST INCOME DCF 
P01 400 ws -400 
P02 ~ 100 82 
P03 me 100 67 
P04 a 100 55 
P05 " 100 45 
P06 - 100 3T 
P07 = 100 30 
P08 “ 100 24 
P09 - 100 20 
P10 = 100 16 
Pri = 100 13 
P12 = 100 11 
TOTAL 400 1100 
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w > * FILE: "EX0S text"  * * * 


sTITLES. . 
1 "PLAN80 EXAMPLE #5 - INTERACTIVE" 
2 "INTERNAL RATE OF RETURN MODEL" 
3 "(DISCOUNTED CASH FLOW) " 
: COLUMNS 
INVEST 
INCOME 
DCF 
: ROWS 
POl 
P02 
P03 
P04 
P05 
P06 
P07 
P08 
P09 
P10 
Pll 
P12 
TOTAL ." ". “POTAL" 
sOPTIONS 
ROWWID (5) 
:DATA 
INVEST 400 
INCOME 0 100 te 
sREPEAT "XX08.TEXT" <- - - 


Sh F< Bibs  "XX05. 7 ex" oe ei! 


> INTERACTIVE 
: RULES 
TOTAL = 0 
DCF = @IRR( (INCOME - INVEST) ) 


TOTAL = @SUM(P01..P12) 
:DISPLAY 
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| Internal Rate of Return = 22,3 % Le 


EXAMPLE 6 


Example 6 is an administrative cost center budgeting example. 
‘The @SUM function is an extremely convenient shorthand technique 
for summing large numbers of rows or columns. Note also how 
occupancy expense is calculated as a function of headcount. 

Similar techniques could be used to build flexible euigete or to 
allocate overhead. 


PLAN80 EXAMPLE #6 
ADMINISTRATIVE BUDGET FOR COST CENTER 1001 


1ST 2ND 3RD 4TH FULL 
QTR QTR QTR QTR YEAR 
HEADCOUNT 
EXEMPT 2.0 2.0 2.0 3.0 9.0 
NONEXEMPT 1.0 1.0 Leo 130 4.0 
TOTAL ii 3.0 3.0 4.0 13.0 
EXPENSE 
SALARIES 24.0 25.2 25.2 ye 106.2 
FRINGES ee 7.6 7.6. 9.5 31.9 
OVERTIME 2.0 3.0 2.0 a3 9.3 
SUPPLIES O.7 0.8 0.8 0.8 3.1 
RENTALS 3.5 3.5 3.5 3.5 14.0 
OCCUPANCY 6.1 6.1 6.1 6.9 25.2 
TELEPHONE 2.8 2.8 24 2.8 11,2 
TRANSFERS 3.6 4.1 3.4 3.5 14.6 
TOTAL 49.9 53.1 51,4 AOR Yai 
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* * * PILE: "EBX06.TEXT" * * * 


> TITLES 

1 "PLAN80 EXAMPLE #6" 

2 “ADMINISTRATIVE BUDGET FOR COST CENTER 1001" 
: COLUMNS 

Ql ‘23 "1ST" "Orr 

Q2 (1) "OND" "QTR" 

Q3 ( 1 ) 8 3RD a "QTR" 

Q4 (1) "ATH" "QTR" 

YEAR (1) "FULL" "YEAR" 


: ROWS 
HO] ; "HEADCOUNT" 
" EXEMPT" 
HO2 " NONEXEMPT" 
HOD - {=}. —"-. BOTAL" 
Sol (S) "EXPENSE" 
" SALARIES" 
S02 " FRINGES" 
S03 " OVERTIME" 
S04 ; " SUPPLIES" 
S05 " RENTALS" 
S06 " OCCUPANCY" 
S07 " TELEPHONE" 
S08 " TRANSFERS" 
S99: (-=)} *  FOTAL" 
DATA 
HOl = 2 2 2 3 
HO2 = 1 1 1 1 
SOL <= 24.0 °25.2 25.2 31.8 
S03 = ae eee 2p Zes 
S04 = eds ees 8 8 
S05 = S63 te Bes 2365 
S07 = Lee >. £50 - £28 —-2,8 
S08 = 306. Bol 3082 3.5 
: RULES 
H99 = 4HOl + HO2 
SO2 = .30 * SO1 ; 
S06 = -4.0 + (.8*HO1) + (.5*HO2) 
S99 = @SUM{(S01..S08) 
YEAR = @SUM(Q1..04) 
: DISPLAY 
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EXAMPLE 7 
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Example 7 


into a summary. 
One DATA and one RULES section. 
statement 
cost center. 


INCLUDE 


each 


+ 


Shows the consolidation of three. cost center 


budgets 

It should be compared to Example 6, which has 

Example 7, in contrast, uses the 

to read title line #3 and a DATA section for 
Note that for each cost center we 


initialize data values to zero, 


* include the title and data for the particular cost center, 
* include a common set of rules, 
* display the results, and 
* put the results into a file, 
Then for the consolidation we 


* initialize data values to zero, 
* get each previously saved file using the "add" option, 
* introduce an appropriate title, and 
* display the results. 
The page containing PLAN80 statements is supplemented with 
diagrams to help you understand the consolidation, 


PLAN80 EXAMPLE #7 
BUDGET CONSOLIDATION 
SUMMARY OF COST CENTERS 1001-1003 


1st 2ND 3RD ATH FULL 
QTR QTR QTR QTR YEAR 
HEADCOUNT 
EXEMPT 10.0 10.0 10 20 12:20 43.0 
NONEXEMPT 24 <0 25.0 25.0 26.0. 10070 
TOTAL 34.0 35.0 35.0 30.0 71143 20 
EXPENSE 
SALARIES 162.0 165.7 (168.95: 16942 2e78 3 
FRINGES 48.6 49.7 50.5 54.7 > 2035 
OVERTIME 145 14.9 12.8 ee, 56.7 
SUPPLIES 12.) 1p.2 12.3 11.8 47.6 
RENTALS 23.5 23.5 29 5 23.5 94.0 
OCCUPANCY 39.0 32.5 32.5 $5.4 “132 4 
TELEPHONE 16.4 16.4 16.4 16.4 65.6 
TRANSFERS ~ ~ - - ~ 
TOTAL 308.9. “314.3 = 996.2 336.0. 1978.1 
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PLAN80 EXAMPLE #7 
BUDGET CONSOLIDATION 
COST CENTER 1003 


1ST 2ND 3RD 4TH FULL 
OTR OTR QTR QTR YEAR 
HEADCOUNT 
EXEMPT 2.0 2.0 
NONEXEMPT 21.0 22.0 
TOTAL 23.0 24.0 


PLAN80 EXAMPLE #7 
BUDGET CONSOLIDATION 
COST CENTER 1002 


1ST 2ND 3RD 
QTR QTR QTR 

HEADCOUNT 
EXEMPT 6.0 6.0 6.0 
NONEXEMPT 2.0 2.0 2.0 
TOTAL 8.0 8.0 8.0 


PLAN80 EXAMPLE #7 
BUDGET CONSOLIDATION 
COST CENTER 1001 


1st 2ND 3RD ATH 
OTR OTR OTR QTR 
HEADCOUNT | 
EXEMPT 2.0 2.0 2.0" 3.0 
NONEXEMPT 1.0 1.0 1.0 1.0 
TOTAL 3.0 3.0 3.0 4.0 
EXPENSE 
SALARIES 24.0 25.2 25.2 31.8 106.2 
FRINGES P02 7.6 7.6 9.5 31.9 
OVERTIME 2.0 3.0 2.0 2.3 9.3 
SUPPLIES 0.7 0.8 0.8 0.8 3.7 
RENTALS 3.5 3.5 3.5 3.5 14.0 
OCCUPANCY 6.1 6.1 6.1 6.9 25.2 
TELEPHONE 2.8 2.8 2.8 2.8 13.3 
TRANSFERS 3.6 4.1 3.4 3.5 14.6 
TOTAL 49.9 53.1 51.4 61.1 215.5 
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Lace wes i 


FILE: "EX07.TEXT" * * * 
: TITLES | :TITLES | 
1 "PLAN80 EXAMPLE #7" | 3 "COST CENTER 1001" | 
2 "BUDGET CONSOLIDATION" ------ | sDATA : | 
: COLUMNS | | HO1 = 2 2 2 2 | 
Ql (1) "1ST" "QTR" | | HO2 = 1 1 1 4 
Q2 (1) "2ND" "OTR" | | sol = 24.0 25.2 25.2 31.8 | 
03 (1) "3RD" "QTR" | | S03 es? 08 0 250. 23 
Q4 (1) "4TH" "OTR" | | so4 = S738 .8 8 | 
YEAR (1) "FULL" "YEAR" | | S05 =v g6 325 3.5 9.51 
: ROWS | | S07 = 2.8 258 2.6. 2.8 -| 
HOl "HEADCOUNT" | | _s08 2 236 AS 3d 35 
" EXEMPT" | 
HO2 " NONEXEMPT" | 
H99 (-) ©" TOTAL" | 
S01 (S) "EXPENSE" | 
" SALARIES" | | :TITLES | 
S02 " FRINGES" | | 3 "COST CENTER 1002" | 
S03 " OVERTIME" | -- | :DATA | 
S04 " SUPPLIES" | I | HO1 = 6 6 6 7A 
S05 " RENTALS" | | | HO2 = 2 2 2 2 | 
S06. " OCCUPANCY" | | | Sol = 64.0 65.0 66.0 70.8 | 
S07 " TELEPHONE" | | | S03 = 6 0 5.0°°5.0) 6.3 -] 
S08 " TRANSFERS" | | 608 See ey eee Oe eS ee 
S99 (-=) " TOTAL" | [ | S05 = 7e5 . 7eSe 7 5 758 
: INITIALIZE | | | S07 SG 5,8 +5. 8-558 
:INCLUDE "CC1001.TEXT" <--- | | ___ s08 = 07,6 8.1 8.4.8.5 | 
: INCLUDE "PROCO7.TEXT" <- | 
:PUT "T1001" | | 
s INITIALIZE | | 
: INCLUDE "CC1002.TEXT" <------- a ee 
:INCLUDE "PROCO7.TEXT" <-| | 2-MTLES = 
:PUT "T1002" | | 3 "COST CENTER 1003" 
s INITIALIZE | | :DATA 
sTNCLUDE “CC1003:, TEXT". <—--—=--—--- | HO1 = 2 2 Pree D 
:INCLUDE "PROCO7.TEXT" <-| | HO2 = (2) -92 «22.23 
:PUT "T1003" | | sol = 74.0 75.5 77.0 79.8 
‘ | | S03 = 7.3 6.9 5.8 6.1 
: * * NOW CONSOLIDATE * * | . s04 = 9.7°°8.8 9.2 9.5 
: | | S05 = 12.5 12.5 12. 912.5 
: INITIALIZE | | S07 = 758 7,8  WeOe=gi8 
:GET "T1001" ADD | | = - - ~ - 
:GET "T1002" ADD | 
:GET "T1003" ADD | 
: TITLES 7 | 
3 "SUMMARY OF COST CENTERS 1001-1003" 
: DISPLAY | 
| :RULES I 
----- | H99 = HO] + HO2 | 
| S02 = S01l.* .30 | 
| S06 = 4.0 + (.8*HO1) + (.5*HO2) | 
| S99 = @SUM(S01..S08) | 
| YEAR = @SUM(Q1..04) [ 
| | 


_s=DISPLAY 
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APPENDIX B 


LANGUAGE OPERATING 


Introduction 
Procedure Il 
Procedure 2 
Procedure 3 
Procedure 4 
Procedure 5 
Procedure 6 
Procedure 7 
Procedure 8 
Procedure 9 
Procedure 10 
Procedure ll 
Procedure 12 
Procedure 13 
Procedure 14 


SYSTEM PROCEDURES 


Booting the Language System 
Listing the Active Volumes 
Changing the Prefix Value 
Listing the Contents of a Diskette 
Formatting a Diskette 

Copying an Entire Diskette 
Copying a File 

Deleting a File 

Crunching a Diskette 

Changing Diskette and File Names 
Creating a New Text File 

Editing an Existing Text File 
Leaving the Editor 

Executing Code Files 
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INTRODUCTION 


Included are a set of procedures which provide step by. step 
instructions for a large number of tasks such as making backup 
copies of diskettes, listing a diskette's contents, executing the 
editor and running programs such as PLAN80. Many of the’ later 
procedures are based on materials introduced in earlier ones. 
Thus they should be studied in sequence at first and later used 
for reference, 


If you are already familiar with the Apple Language System then 
you probably won't need to refer to these procedures, However, 
you may learn something from reading them once. 


If you are new to the Language System and plan to use it for more 
than PLAN80 you will find that these procedures will give you a 
good feel for the system. Your experience will help you’ when 
you are ready to use the system as a text processor or for 
languages that operate within the Language System. 


If you are new to the Language System and want to use it only for 
programs such as PLAN80 then you will find these procedures more 
than adequate to help you operate comfortably. At some future 
point you may want to learn other editor and filer commands, but 
it will never be necessary that you do so, 


The Filer procedures and Editor commands are covered in Chapters 
3 and 4 of the APPLE PASCAL Operating System Reference Manual. 
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Procedure 1 - Booting the Language System (Note 1) 


For Single and Multiple Drive Systems 
1. Place the APPLE]: diskette (or any other diskette which has 
the files SYSTEM.APPLE, SYSTEM.PASCAL and SYSTEM.MISCINFO) 
in drive #4. This is the first drive connected to the disk 
interface card in slot 6 of your computer (Note 2). 
2. Turn on power and wait about 15 seconds for the COMMAND: 
prompt line and the welcome which appear as: (Note 3) 


COMMAND: E(DIT, R(UN, F(ILE, C(OMP, L(INK, X(ECUTE ... 


WELCOME APPLE1, TO APPLE II PASCAL 1.1 
BASED OF UCSD PASCAL SYSTEM II.1 
CURRENT DATE IS dd-mmm-yy & 


3. If you wish to change the current date key "F" (for filer) 
and --"D" (for Date) The screen will repeat the current 
date and let you change it with the message 


DATE SET: <1l..31>-<JAN..DEC>+-<00..99> 
TODAY IS dd-mmm-yy 
NEW DATE ? 


You may then enter a new date in the format "23" or "23- 
MAR" or "23-MAR-81" and press RETURN. The new date will be 
associated with the boot diskette until subsequently 
changed and will be associated with any file subsequently 
created or modified. 

4, Key "Q" (for quit) to leave the filer and return to the 
COMMAND: prompt line. 


Notes: 

1. The diskette used for booting the Language System is called 
the "boot" or "root" volume, The word "boot" is derived 
from the idea of pulling oneself up by one's own 
bootstraps. When. <a computer first starts up it.doads a 
very small program, which in turn loads a larger § program, 
etc. This process of a system's loading itself is called 
"booting". 


i i i i i l,i ee 


2. You must remove the cover of your Apple II computer to. see 
its slots. There are eight of them in the rear and from 
left to right are numbered zero to seven. An Apple II with 


| the Language System installed will have a Language card 
: installed in slot 0 and a disk controller card in slot 6. 
3. Your PLAN80: diskette runs the file SYSTEM.STARTUP instead 


of presenting the welcome message. 
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Procedure 2 - Listing the Active Volumes 
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For Single and Multiple Drive Systems 


1s 
2. 


3s 
4. 


Note: 


If you are already in the filer skip to step 4. 

Go to the COMMAND: prompt line or boot the Language System 
(Procedure 1) if necessary. 

Key "F" (for filer). 

Key "V" (for volumes). Depending upon your equipment and 
the diskettes inserted in your drive(s), the display will 
appear as 


VOLS ON-LINE: 
1 CONSOLE: 
Z SYSTERM: 
4 <diskette name>, 
5 <diskette name> 
6 PRINTER: 

7 REMIN: 

8 REMOUT: 

9 <diskette name> 
10 <diskette name> 
11 <diskette name> 
12 <diskette name> 


“ROOT VOL IS - <diskette name> 


PREFIX IS - <diskette name> 


Every system will show the first two volumes, which 
correspond to the monitor or tv screen and to the keyboard. 
Volume 4 is the disk drive from which the system is booted 
and 5 is the second drive attached to the disk interface 
card installed in slot 6 in the back of your computer. 
Volume 6 will be named "PRINTER:" if you have an interface 
card installed in slot l. 

Volumes 7 and 8 will be named "REMIN:" and "REMOUT:" if you 
have an interface card installed in slot 2. 

Volume 9 is the first disk drive attached to a disk 
interface card in slot 4, and volume 10 is the second 
drive. 

Volume 11 is the first disk drive attached to a. disk 
interface card in slot 5, and volume 12 is the second 
drive. 

The root volume is the name of the disk used to boot’ the 
Language System. 

The prefix is the same as the root volume unless changed by 
the filer's prefix command (procedure 3). 


Volume names, including diskette names, always end with 
a colon, ":". The root volume may always be addressed as 
"ke", and if you use only a colon it has the same effect 
as uSing the prefix name followed by a colon. 
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Procedure 3 - eee bee! the Prefix Value 


For Single and Multiple Drive Systems 


is 


If you are already in the filer skip to step 4. 

Go to the COMMAND: prompt line or boot ks Language System 
(Procedure 1) if necessary. 

Key "F" (for filer). 

Key "P". The prompt line will read "PREFIX TITLES BY 2s 
Type the name of a diskette, as in "XY¥Z:" and press RETURN. 
The system will respond "PREFIX IS XYZ: ?". 

The prefix value remains in effect until the system is 
rebooted or another prefix value is provided. 


Many subsequent procedures will ask for file names to be 
provided. You will be expected to provide full file names, 
including the diskette name, whenever the file is on a 
diskette whose name is different from that of the prefix 
value, : | 
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Procedure 4 - Listing the Contents of a Diskette 


For Single and Multiple Drive Systems 


1. 
2 


3. 
4. 


Dy 


10.. 


ll. 


If you are already in the filer skip to step 4. 
Go to the COMMAND: prompt line or boot the lesa System 
(Procedure 1) if necessary. 
key "P? (for fiver). : 
Key "E" (for extended listing). The prompt line will read 
DIR LISTING OF ? 
Make sure the diskette has been inserted into any available 
drive, type one of the following and press RETURN 
a. the name of the diskette, 
_b. the volume number of the drive in which the diskette 
has been inserted as in "#43", "#53", etc., or 
c. "*" to see the directory. of the diskette used in. 
booting the system, 
d. ":" to see the directory of the diskette whose name 
equals that of the current prefix value (procedure 3). 
The directory listing for the diskette APPLE1: will be: 


APPLE]: 
SYSTEM. APPLE 32 9-NOV-80 6 DATA 
SYSTEM. PASCAL 41 22-SEP-80 38 DATA 
SYSTEM.MISCINFO 1 4-MAY-79 79 DATA 
SYSTEM. EDITOR 47 24-SEP-80 80 CODE 
SYSTEM. FILER 28 18-SEP-80 127 CODE 
SYSTEM.LIBRARY 34 19-SEP-80 155 DATA 
SYSTEM. CHARSET 2 14-JUN-79 189 DATA 
SYSTEM. SYNTAX 14 1-AUG-80 191 TEXT 
<UNUSED> 75 205 


8/8 FILES, 75 UNUSED, 75 IN LARGEST 


The numbers in the column following the file name show the 
lengths of the files in terms of blocks which are 512 bytes 
(equivalent to characters) long. 

The dates on your system may be different. 

The numbers following the dates show the number of 512 byte 
blocks occuring before the file named on each line, Thus 
SYSTEM.APPLE has 6 blocks before it, which incidentally 
contain the directory information. You should note that 
there are a total of 280 tracks, providing 143,360 bytes of 
storage, including the directory blocks. 

The last column indicates the type of the file. Files that 


you execute, like PLAN80, are code files, and files 


produced by the editor are text files. All OPner files are 
data files. 

The last line indicates that 8 out of a eebnd of 8 files on 
the diskette were shown, that a total of 75 blocks’ were 
unused and that the largest set of Serle a unused blocks 
contained 75 blocks. 
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Procedure 5 - Formatting a Diskette 


For Single and Multiple Drive Systems 


1. 
2e 


Note: 


Go to the COMMAND: prompt line or boot the Language System 
(Procedure 1) if necessary. 

Key "X" (for execute) and place the diskette APPLE3: in 
drive #4. The prompt line will read “EXECUTE WHAT FILE ?". 
Type "“APPLE3:FORMATTER", press RETURN and wait about 10 
seconds for the message 

“FORMAT WHICH DISK (4, 5, 9..12) ae 

Place a diskette in drive #4, key na" and press RETURN. 

If the diskette to be formatted has previously been 
formatted then you will receive the message 

"DESTROY DIRECTORY OF xxxx: ?", where xxxx: indicates the 
diskette's name, If you do want to format the diskette 


then key "Y". If the diskette has not been formatted 


previoulsy then no message will appear. 

The actual formatting will take about 30 seconds. You will 
see the message "NOW FORMATTING DISKETTE IN DRIVE 4". Then 
you will again see the "FORMAT WHICH DISK ... ?" message as 
in step 3. You may repeat the formatting process for any 
number of diskettes. When done press RETURN without 
entering a drive number and you will get the message 

"PUT SYSTEM DISK IN #4 AND PRESS RETURN." 

Remove the last diskette formatted, insert the boot 
diskette and press RETURN. You will see "THAT'S ALL FOLKS" 
and the COMMAND line will appear at the top of your screen. 


In a multiple drive system it is possible to format disks 
in any drive, but it is safer to remove all other diskettes 
and use #4 for formatting. 


Each newly formatted diskette will have been named "BLANK:" 
and its directory listing appears as: 


BLANK : 


< UNUSED > 274 6 
0/0 FILES, 274 UNUSED, 274 IN LARGEST 
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Procedure 6 - Copying an Entire Diskette 


For Single and Multiple Drive Systems 


2. 


If you are already in the filer skip to step 4. 

Go to the COMMAND: prompt line or boot the Language System 
(Procedure 1) if necessary. 

Key "F" (for filer). 

Rey. “Y", The prompt line will read "TRANSFER ?". 
Type the name of the source diskette (the one to be copied, 
as in "APPLE1:") and press the RETURN key. Wait for the 
prompt line "TO WHERE ?". 
Type the name of the destination diskette (usually "BLANK:" 
as created by the formatter program) and press RETURN. The 
computer will then ask, "TRANSFER 280 BLOCKS ? (Y/N)" 


For Single Drive Systems 


8. 


9. 


Make sure that the source diskette has been inserted and 
key "Y". (Key "N" to abort the copy process.) 

You will then be told alternately to insert the source and 
destination diskettes for each file on the source diskette. 
When you first insert BLANK: (or any other diskette). you 
will be asked "DESTROY BLANK ?" since the copying process 
will eliminate any information on the destination diskette. 
You should key "Y" to proceed and then insert each diskette 
as directed, pressing the space bar to continue. 

When all files have been copied you will see a message 
Similar to "“APPLE1: --> BLANK:", indicating that the 
copy process is complete, 


For Multiple Drive Systems 


10. 


Loe 


12. 


Make sure that the source diskette is in one drive and that 
the destination diskette is in another. Key "Y". (Key "N" 
to abort the copy process.) 
Since the copy process will eliminate any information on 
the destination diskette you will be asked 

"DESTROY BLANK ?", Key "Y" to proceed. 

Copying will take about 30 seconds and at the conclusion 
you will see a message similar to 

"APPLE1L: --> BLANK:". At this point you must remove 
at least one of the two diskettes. They both have the same 
name and it is possible for both diskettes to become 
unreadable if you attempt to operate simultaneously with 
two diskettes of the same name. 
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Procedure 7 - Copying a File 


For Single and Multiple Drive Systems 

1. If you are already in the filer skip to step 4. 

2. Go to the COMMAND: prompt line or boot the Language System 
(Procedure 1) if necessary. 

3. Key "F" (for filer). 

4. Key "fT". The prompt line will read “TRANSFER ?" 

5. Type the name of the file, make sure the diskette 
containing the file has been inserted, and press RETURN. 
You will then see the prompt line "TO WHERE ?". 

6. Type the name of the destination diskette followed either 
by a new file name, if the name is to be changed, or by a 
dollar sign as in "BLANK:$" if the name is not to be 
changed. Make sure the destination diskette has. been 
inserted and press RETURN. In a few seconds, after the 
copying is complete, you will see a message of the form, 
"APPLE1:SYSTEM.APPLE --> BLANK:SYSTEM.APPLE" 

7. You will be in the filer and may repeat from step 4 to copy 
other files. When finished you may want to display the 
directory of the destination diskette (procedure 4). 


Notes: 

1. When copying files for multiple drive systems as in this 
procedure, the diskette name of the destination diskette is 
not affected. Hence, there is no need to remove a dikette 
immediately after the copy operation as there is when an 
entire diskette is copied as in procedure 6. 


2. A file name includes diskette identification. A diskette 
may be identified in several ways. First, the diskette may 
be named explicitly as in “"APPLE1:SYSTEM.APPLE". Second, 
the diskette may be identified by location as in 
"#4: SYSTEM.APPLE". (Location in terms of disk drive 
numbers are noted in procedure 2.) Or third, the diskette 
may be implied by omitting the diskette name as in 
"SYSTEM.APPLE". In this case the implied diskette name is 
that of the prefix value (procedure 3). 
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PEOcedare 8 - Deleting a File 


For Single and Multiple Drive Systems 


1. 
2% 


3. 
4. 
ie 


Tf you are already in the filer skip to step - 

Go to the COMMAND: prompt line or boot the Language System 
(Procedure 1) if necessary. 

Key "F" (for filer). 

Rey ks The prompt line will read "REMOVE ?", 

Type the file name and press RETURN. The full file name, 
including diskette name, will be shown as in 


MYDISK:EX01.TEXT --> REMOVED 


UPDATE DIRECTORY ? 


If you wish for the deletion to occur then Reyes, Any 
other key will abort the deletion. In both cases you will 
be returned to the filer. 


Procedure 9 - Crunching a Diskette 
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Por Single and Multiple Drive Systems 


1. 
2. 


Notes: 


If you are already in the filer skip to step 4. 

Go to the COMMAND: prompt line or boot the Language System 
(Procedure 1) if necessary. 

Key "F" (for filer). 

Key "K", The prompt line will read "CRUNCH ?", 

Type the file name and press RETURN. You will be 

asked "FROM END OF DISK, BLOCK 280 ? (Y/N)". 

Key "Y" and all files will be moved forward so that all 
unused space occurs as a single group of blocks at the end 
of the diskette. 


Files must be stored in consecutive unused blocks. Hence, 
this procedure is particularly important when editing a 
file whose size is more than half the size of the total 
unused space on the diskette. Consider the following: 


You have a file 20 blocks long and there are 40 unused 
blocks at the end of the file. You edit the file without 
changing its length, It is then stored immediately after 
the original file. The unused space still totals 40 
blocks, but it is now divided into two 20 block groups. 
If you edit the file again and increase its length by 
even one block there is insufficient room for the file, 


Crunch your diskette before editing to avoid this situation 
with diskettes having limited unused space. 
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Procedure 10 - Changing Diskette and File Names 
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For »ingle and Multiple Drive Systems 


i. 
2. 


If you are already in the filer skip to step 4. 
Go to the COMMAND: prompt line or boot the Language System 


(Procedure 1) if necessary. 


Key "F" (for filer). 


Key 2"'C".. -...: fhe prompt line will read "CHANGE ?". 
To change a dikette's name type the name of the diskette or 
its location, as in "#4: Press RETURN and the message 


"CHANGE TO WHAT ?" will appear. Then type in the new 
diskette name, including the colon, and press RETURN. A 
message Similar to "DISK1: --> DISK2:" will appear. 

To change a file name type in the current name of the file 
and press RETURN. The message "CHANGE TO WHAT ?" will 
appear. Then type the new file name. You should remember 
to include any applicable appendage such aS ".TEXT", but 
you do not need to identify the diskette since since that 
was already done. You will see a message Similar to the 
following: . “DISK1:FILEA.TEXT ---> DISK1:RILEB.TEXT". 


Procedure ll - Creating a New Text File 


For Single and Multiple Drive Systems 


es 


Go to the COMMAND: prompt line or boot the Language System 
(Procedure 1) if necessary. 

Key "E" (for editor). Your screen should say, 

"NO WORKFILE IS PRESENT. FILE ?". 

Press RETURN to enter the edit mode (or ESCape and _ then 
RETURN to return to the COMMAND: prompt line.) 

First insert, then delete or change text using appropriate 
cursor moving and text changing commands (Appendix C). 
Continue with procedure 13, “Leaving the Editor". 


ae 


Procedure 12 - Editing an Existing Text File 
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For Single Drive Systems 


1. 


If the file to be edited is not on the same diskette as the 
editor then you must copy it onto the latter diskette using 


procedure 7, 


For Multiple Drive Systems 


ie 


Make sure the diskette containing the file to be edited has 
been inserted into an appropriate drive. 


For Single and Multiple Drive Systems 


ce 


Go to the COMMAND: prompt line or boot the Language System 
(procedure 1) if necessary. : 

Key. Fr (for fi ler), 

Key “G", The prompt line will read "GET ?", 

Type in the name of the file you want to edit. Press 
RETURN, and you should see the message, "TEXT FILE LOADED". 
Key "Q" to quit the filer and "E" to call the editor. 
Insert, delete or change text using the appropriate text 
changing and cursor moving commands (Appendix C). 

Continue with procedure 13, "Leaving the Editor", 
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Procedure 13 33 _ Leaving the Editor 


9. 


10. 
ll. 


Key "Q" (for quit) when you are ready to leave the edit 
mode. The screen will appear as 


SOUT. 
U(PDATE THE WORKFILE AND LEAVE 
E(XIT. WITHOUT LEAVING 
R(ETURN TO THE EDITOR WITHOUT UPDATING 
W(RITE TO A FILE NAME AND RETURN 
S(AVE WITH SAME NAME AND RETURN 


ow 


Key "U" if your are done and want to save what you _ have 
edited. Your file will ~be-= saved: on: drive, #4 - as 
SYSTEM.WRK.TEXT. This file is called the "workfile". You 
will receive a message indicating the length of your file. 
Key "E" if you do not want to save what you have edited. 
Key "R" if you do not want. to leave the editor, 

If. you keyed "U" or "E™ you will see the. COMMAND: prompt 
line. 

If you keyed "U" then you may edit the workfile as many 
times as necessary, but you must save it under another name 
before editing any other file. 

Generally all files should be saved when you are done 
editing. To do this key "FP" (for filer). 

Key "S" and you will see either the message "SAVE AS 
<filename> ?" or "SAVE AS ?"., In the former case, which 


results from having used the "G" command to "get" the 


workfile previously, key "Y" and the file will be saved. 
Any other key will cause the message "SAVE AS ?". in this 


case type the name of the file, including the diskette name 


if the file is to be stored on a diskette other than the 
one whose name equals the prefix value (see procedure 3). 


For Single Drive Systems 


Press RETURN. After about 15 seconds you will be asked’ to 
insert the destination diskette if different from the one 
containing the workfile. Do so and press RETURN. 


For Multiple Drive Systems 


Make sure the proper diskette is on-line and press RETURN. 


For Single and Multiple Drive Systams 


If the file was stored on another diskette it will appear 
in the directory of that diskette under its new name. The 
file SYSTEM.WRK.TEXT will remain on its diskette. You will 
see a message of the form 


PLAN80:SYSTEM.WRK. TEXT 
---> NEWDISK: NEWNAME, TEXT 


indicating that the saving process occured. 
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12. If the file was saved on the same diskette as the workfile 
then you will see the message "TEXT FILE SAVED" and will 
find that the workfile was renamed from SYSTEM.WRK.TEXT to 
the new name provided. 

13. Unless you have a specific reason the keep the workfile it 
is a good idea to key "N" (for new) at this point. You 
will get the message "WORKFILE CLEARED". 


Procedure 14 - Executing Code Files 
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For Single and Multiple Drive Systems 

1. Go to the COMMAND prompt line or boot the Language System 
(Procedure 1) if necessary. 

2. Key "X". The prompt line will read "EXECUTE ?". 

3. Insert a disk containing the file you want to execute into 
any drive and type its name, but omit ".CODE". The name 
must identify the diskette by name, location or prefix 
value (see procedure 7). 
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APPENDIX C 


THE LANGUAGE SYSTEM. EDITOR 


em es we ee ee ee ee ee ew errr 


76 Introduction 
76 Cursor Moving Commands 


716" The Set Direction 
77 +Cursor Moving Keys 
Se Repeat Factors 


77 | Display Commands 

77 «Text Changing Commands 

Tees Insert 

78 .. Delete 

78 Change 

79 -The Copy Buffer sy 
“49 To Move a Block of Text 
19 To Copy a Block of Text 

79 #£=xNotes 


a3 Br = 


INTRODUCTION 


The editor is a program which helps you create or modify text 
files, A text file is made up of sequences of characters 
separated by a RETURN character. Each sequence appears as a line 
of text when displayed on a screen or when printed, The input 
files for PLAN80 are text files, 


There are two types of commands used by the editor. The first 
allows you to move the cursor anywhere within the current file, 
and the second permits you to insert, delete or change characters 
at the location of the cursor, 


The following pages discuss the primary cursor moving and text 
changing commands, Less than half of the editor commands are 
introduced, but the ommited ones won't help you initially. You 
can pick them up from Chapter 4 of the APPLE PASCAL, Operating 
System Reference Manual after you are comfortable with the 
commands presented here, 


All of the cursor moving and text Changing commands are entered 
when the EDIT prompt line is showing. Each cursor moving command 
automatically terminates itself and leaves you with the EDIT 
prompt line. 


Fach of the text changing commands, however, is terminated by a 
control-C character or by hitting the escape key. The former is 
indicated by "CTRL-C" and is generated by holding the key marked 
"CTRL" while keying a "C", The latter is indicated by "ESCape" 
and is generated by pressing the key marked "ESC", 


You must get used to the idea of moving the cursor to an 
appropriate location and then entering one of the text changing 
modes, 


CURSOR MOVING COMMANDS 


THE SET DIRECTION 


The EDIT prompt line displays either a ">" or a "<" in the 
upper left hand corner of the screen to indicate a forwards or 
backwards direction, This direction is set by typing the keys 
containing the ">" or "<" signe, You need not use the shift 
key. The set direction affects movement of the cursor when 
using the spacebar, RETURN and "P" keys. 
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CURSOR MOVING KEYS 


Right Arrow - one space to the right 


Left Arrow =- one space to the left 
Spacebar - one space in the set direction 
RETURN key - to the begining of the preceeding or succeeding 


line depending on the set direction 


REPEAT FACTORS 


Each of the cursor moving and "P" commands may be repeated any 
number of times by preceeding the command with a number. 


DISPLAY COMMANDS 


When the EDIT prompt line is showing you may type 
"JBO-E0 jump to the beginning of the file, 
"JE" to jump to the end of a file, or 
"P" to move the display one page in the set direction. 


TEXT CHANGING COMMANDS 


INSERT 


l. From the EDIT prompt line key "I" to enter the insert mode 
and CTRL-C or ESCape to leave. The former accepts what you 
have inserted and the latter rejects all that you~ have 
inserted since last entering the insert mode, no matter how 
many lines are involved. Use ESCape with care. 


| 2. Once in the insert mode you may type any sequence of 
Characters desired, including a RETURN to begin a new line. 


3. If you want to eliminate characters, including RETURNs, 
keyed since entering the insert mode use the left arrow key. 


4. Whenever you use the RETURN key the cursor will line up 
immediately under the first character of the previous line. 
You may then use the left arrow key to move the cursor 
further to the left. You should note, however, that the 
left arrow key will not allow you to move the cursor 
further left if you have not already inserted a RETURN. 
Thus, if you want to insert a new line starting below and 
to the left of a previous line, start your insertion at the 
end of the previous line with a RETURN. 


= 


DELETE 


i 


From the EDIT prompt line key "D" to enter the delete mode 
and CTRL-C or ESCape to leave. The former accepts what has 
been deleted and the latter prevents any deletion from 
occurring, 


While in the delete mode use any of the cursor moving 
commands to delete text. Blanks will appear where text is 
deleted. You may, however, use cursor commands to reverse 
the deletion process, Previously deleted text will 


reappear. 


CHANGE 


1. 


From the EDIT prompt line key "X" to enter the exchange 
mode and CTRL-C or ESCape to leave. The former accepts all 
changes and the latter prevents any of the changes’ from 
being accepted. 


In the exchange mode you may change the character upon 
which the cursor rests with any other character, but not 
with a RETURN. 


The left arrow key may be used to back up over ° characters 
already changed, and they will revert to what they were 


originally. 


The exchange mode is only effective from the initial cursor 
position to the last character of a line. To change a 
following line you must leave the exchange mode, advance 
the cursor to the new line and reenter the exchange mode, 
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THE COPY BUFFER 


The copy buffer allows you to move or copy blocks of text in 
addition to recover from accidental deletions. 


Whenever you insert or delete characters a copy of what you have 
inserted or deleted is placed in a section of storage called the 
copy buffer. 


You may then use the editor's copy command to bring the buffer's 
contents into the workfile starting at the cursor location. From 
the EDIT prompt line key "C" (for copy) and then "B" (for buffer) 
to insert the copy buffer's contents. 


TO MOVE A BLOCK OF TEXT 


For instance, to move a block of text you may 
1. delete the entire block, and type CTRL-C to accept’ the 
deletion, , 
2. move the cursor, and 
3. insert the copy buffer's contents at a new location. 


TO COPY A BLOCK OF TEXT 


Or to copy a block of text you may 
1. delete the entire block, but type ESC to escape from the 
deleteion, 
2. move the cursor, 
3. insert the copy buffer's contents, and 
4. repeat from step 2 any number of times. 


NOTES 


1. The copy buffer's contents are cleared as soon as you first 
enter either the insert or delete mode. 


2. Escaping from an insertion leaves the buffer empty. 
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82 What You Should Do 
82 What PLAN80 will Do 
83  PLAN80 Error Codes 


PLAN80 ERRORS 


APPENDIX D 


t 
| 
i=] 
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WHAT YOU SHOULD DO 


If a PLAN80 statement contains errors, such as the name ROW2 when 
you mean ROW3, there is little PLAN80 can do to help you. You 
must check that your results are reasonable. It's a good idea to 
double check the computer's results for at least one column when 
you first create an application. 


Sometimes PLAN80 won't tell you about very obvious errors. For 
instance, if you omit quote marks from the second line of a row 
description PLAN80 will assume that you are defining another row. 


WHAT PLAN80 WILL DO 
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When PLAN80 encounters a statement whose syntax is incorrect for 
any reason then you will get a message. Most messages indicate 
that PLAN80 was expecting a equal sign, a valid name, etc., but 
found something else. 


Fortunately, PLAN80 will also tell you just where the "something 
else" was found. You will see a "“" on the line beneath the line 
containing the error. The error is usually immediately above the 
ac’ OF 15 -Sust- to the left. However, you should always’ look 
backwards a line or two, because you may have made some _ other 
error which was syntacticaly correct, but not what you intended, 
and which resulted in the error noted. Most of the time you will 
recognize a misspelled name or keystroke error, or realize that 
you confused one statement with another, 


When PLAN80 does indicate an error you will usually be given the 
choice of continuing or of leaving PLAN80 so you can use _ the 
editor to fix your incorrect statement. If you continue then 
you may discover other errors, but don't try to salvage results. 
Correct your input statements and begin again when you have found 
all your syntax problems. 
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PLAN80 ERROR CODES 


CODE EXP r 


0 A control statement, beginning with ":", expected. 
Current line ignored. 

1 Invalid control statement. Check spelling. 

2 ":;COLUMNS" expected. At least one column must be 
defined prior to statement shown, which will be 
ignored. 

3 ":ROWS" expected. At least one row must be defined 


prior to statement shown, which will be ignored. 

4 Too many rows or columns. See Appendix E for limits. 
Z Opening quote mark expected. 

6 Closing quote mark depeutank 

7 Opening parenthesis expected. 

8 Closing parenthesis expected. 

9 Equals sign expected. 
10 Operator (+,-,* or /) expected. 
1l Invalid option name. 


12 "COLUMNS" or "ROWS" expected. You may be missing a 
control statement such as :RULES or :DATA. 


13 Invalid character. Numeric values must begin with a 
digit, a minus sign or a decimal point. 


14 Invalid column or row name. 


15 Duplicate column or row name. Each column or row 
must have a unique name. 


16 Diskette not on-line or no space available. 

17 Mathematical operator (+,-,*,/ or ”) expected. 
18 Continuation of a rule expected. 

19 Word "ALL" or opening parenthesis expected. 

20 Invalid function name. 


- 83 - 


CODE EXPLANATION 


2d Sum of undiscounted values must be positive. 
22 First undiscounted value must be negative. 
24 Wrong type. 

25 Comma expected. 

26 Le te Rete rea. 

27 Only single valued expression permitted. 

28 Limitation on total length of row and column 


descriptions. See Appendix E. 


29 File not found. Check spelling. Also check 
diskette name and prefix value, 
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APPENDIX E 
SIZE CONSIDERATIONS 


86 Maximum number of Columns and Rows 
87 Text File Space Requirements 
87 If Diskette Space is a Problem 


Ay 
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MAXIMUM NUMBER OF COLUMNS AND ROWS 


The following table indicates the maximum number of columns’ and 
rowS which may be defined in a PLAN80 application. Column A 
indicates possible numbers for either the column or row 
dimension, and Column B shows the number to which you are limited 
in the other dimension, In other words, 


* if you have 13 columns then you can have up to 181 rows, or 
* if you have 100 rows you can have up to 29 columns, etc, 


Column A Column B 


1 418 
2 378 
3 344 
5 292 
6 272 
10 212 
12 191 
13 181 
a5 165 
20 135 
25 114 
30 99 
40 7h 
50 63 
60 53 
70 44 
80 38 
90 33 
100 29 
120 23 
150 17 
200 11 
250 7 
300 4 


The maximum number of rows and columns will be reduced if you use 
INCLUDE or REPEAT statements. 
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TEXT FILE SPACE REQUIREMENTS 


Each character of a text file requires one byte. However, a text 
file does not include all blanks shown on your screen. Included 
are those upon which the cursor will rest when you space’ through 
the file one character at a time. This includes the RETURN. 
Also included at the start of most lines are two additional 
characters which tell the editor the number of positions’ to 
indent the line, 


When leaving the editor, updating the workfile, you will be told 
the length of your file with the message: 


WRITING ... 
YOUR FILE IS xxxx BYTES LONG. 


The lowest unit of space is a 512-byte block, of which there may 
be up to 274 on each diskette. A text file is always preceeded 
by two blocks, which contain control information other than the 
text itself. Subsequent blocks, which contain text, are 
allocated in two block multiples. Thus any text file is at least 
four 512-byte blocks long. The total number of blocks required 
for text of various lengths is as follows: 


Length of Text (Bytes) Total Number of Blocks 


1 - 1,024 4 
1,025 - 2,048 6 
2,049 - 3,072 8 
3,073 - 4,096 | 10 


IF DISKETTE SPACE IS A PROBLEM 


If your computer contains two or more disk drives then the second 
drive should give you ample flexibility to insert as many 
diskettes as might be required for applications of any size or 
complexity. Fach empty diskette holds 274 512-byte blocks of 
unused space, If you have only one drive then you will have 
approximately 60 blocks of unused space on a PLAN80 master. This 
is enough space for nearly 30,000 characters of text, but if you 
need more than this for a very large application you can remove 
the files SYSTEM.EDITOR and SYSTEM.FILER (procedure 8) and move 
the remaining files forward (procedure 9). . This will increase 
the amount of unused space by 73 blocks. Then do all editing on 
other diskettes such as APPLEl: and use the filer to copy edited 
files to your revised PLAN80 master. 
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B 


booting the system 10, 13, 63 
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BLANK: 14, 67 


C 


cash flow example 48-53 
C(hange, Filer command 17, 19, 71 
changing text; -ih Editor: 31; 78 
command prompt line 10, 1l, 22 
CONSOLE: 12, 24, 64 
consolidation example 58-60 
copy buffer, in Editor 32, 79 
copy protection 13 
C(opy , Editor command 32, 79 
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copying a diskette 17-18, 68 
copying .a file 15, 16, 69 
creating a text file 35, 71 
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.cursor , in Editor 29-30, 76-77 
cursor , in DISPLAY 23 
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D(ate , Filer command 28, 63 
D(elete , Editor command 31, 78 
deleting a block of text 32, 78 
deleting a file 19-20, 70 
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disk drives 6 
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copy buffer 32, 79 
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deleting a block of text 32, 78 
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renaming a diskette 17, 71 
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G(et , Filer command 28-29, 72 
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I(nsert , Editor command 31, 77 
INTERACTIVE 24, 25, 38-39 
internal rate of return 54-55 
interrupting PLAN80 

from DISPLAY mode 23 

from INTERACTIVE mode 25 

in general 26 
J 
J(ump , Editor command 29, 77 
K 


"key" , meaning of 7 
K(runch , Filer command 20, 70 


L 

listing PLAN80 statements 26 
M 

moving a block of text 79 
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N(ew , Filer command 74 
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P(age , Editor command 29, 77 
PLAN80.CODE 13 


PLAN80: diskette 6, 10, 13, 15-18 


PLAN80 prompt line 22, 24 
prefix 12, 26, 64, 65 

P(refix , Filer command 25, 65 
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PRINTER: 12, 24, 26, 64 
purchase agreement , cover, 11 
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Q(ult , Editor command 34, 73 
Q(uit , Filer command 11 
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renaming a file 19, 71 
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R(emove , Filer command 19, 70 
RESET 10 
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S(ave , Filer command 34, 73 


Set direction, in Editor 30, 76 
Size considerations 86-88 


_SYSTEM.APPLE 16, 66 


SYSTEM.STARTUP 13, 16, 63 
SYSTEM.WRK.TEXT 34, 73-74 


T 

T(ransfer , Filer 
command 15-18, 68, 69 
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U 


unused space on a diskette 20, 70 


U(pdate , Editor command 34, 73 
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volume names and numbers 12, 64 
V(olumes , Filer command 12, 64 


X(change , Editor command 31, 78 
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